Open sea MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Open sea MCP or direct API to search NFT collections, fetch asset details, track portfolio value, and monitor trending items through natural language.

Open sea logoOpen sea
Api Key

OpenSea is the world's first and largest NFT marketplace for digital collectibles and crypto assets. Instantly buy, sell, and explore NFTs across blockchains, all in one place.

24 Tools

Try Open sea now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Open sea
Try asking
TOOLS

Supported Tools

Every Open sea action and event your agent gets out of the box.

Build criteria offer

Build a portion of a criteria offer including the merkle tree needed to post an offer.

Cancel order

Offchain cancel a single order, offer or listing, by its order hash when protected by the SignedZone.

Create criteria offer

Create a criteria offer to purchase any NFT in a collection or which matches the specified trait.

Create item offer

Create an offer to purchase a single NFT (ERC721 or ERC1155).

Create listing

List a single NFT (ERC721 or ERC1155) for sale on the OpenSea marketplace.

Fulfill listing

Retrieve all the information, including signatures, needed to fulfill a listing directly onchain.

Fulfill offer

Retrieve all the information, including signatures, needed to fulfill an offer directly onchain.

Get account

Get an OpenSea Account Profile including details such as bio, social media usernames, and profile image.

Get all listings by collection

Get all active, valid listings for a single collection.

Get all offers by collection

Get all active, valid offers for the specified collection.

Get best listing by nft

Get the best listing for an NFT.

Get best listings by collection

Get the cheapest priced active, valid listings on a single collection.

Get best offer by nft

Get the best offers for an NFT.

Get collection

Get a single collection including details such as fees, traits, and links.

Get collections

Get a list of OpenSea collections with optional filtering and pagination.

Get collection stats

Get stats for a single collection on OpenSea.

Get contract

Get a smart contract for a given chain and address.

Get events

Get a list of events from OpenSea based on various filters like timestamps and event types.

Get listings

Get the complete set of active, valid listings.

Get nft

Get metadata, traits, ownership information, and rarity for a single NFT.

Get order

Get a single order, offer or listing, by its order hash.

Get payment token

Get a smart contract for a given chain and address.

Get traits

Get the traits in a collection.

Refresh nft metadata

Refresh metadata for a single NFT.

SETUP GUIDE

Connect Open sea MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK and Claude Agent SDK
2

Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
Initialize the Composio client and create a Tool Router session
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Get all listings for the Bored Ape Yacht Club collection' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent
SETUP GUIDE

Connect Open sea API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Open sea Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List all active NFT listings for the Bored Ape Yacht Club collection'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Open sea actions with your Agent

Why Use Composio?

AI Native Open sea Integration

  • Supports both Open sea MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for searching, trading, and analyzing NFTs on Open sea

Managed Auth

  • Handles Open sea API key setup and lifecycle management
  • Central hub to manage, scope, and revoke Open sea API access
  • Scoped, per-user credentials for safer integration—no more hard-coded keys

Agent Optimized Design

  • Tools are tuned for language model agents to fetch, list, and update NFT data flawlessly
  • Comprehensive execution logs let you review every action and response

Enterprise Grade Security

  • Fine-grained RBAC for controlling which agents and users access Open sea
  • Least-privilege, scoped API key usage for every connection
  • Full audit trail of agent actions for compliance and visibility
FAQ

Frequently asked questions

Yes, Open sea requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Open sea.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Open sea tool your agent needs.Free to start.

Start building