Open sea MCP server for AI agents and assistants

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

Request offchain cancellation of a SignedZone-protected order, offer, or listing by chain, protocol, and order hash.

Create criteria offer

Submit a criteria offer creation request to OpenSea.

Create item offer

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

Create listing

Submit a listing for a single NFT (ERC721 or ERC1155) on OpenSea.

Fulfill listing

Request fulfillment information for an OpenSea listing, including transaction and order details intended for fulfilling it onchain.

Fulfill offer

Request fulfillment information for an OpenSea offer, including transaction and order details intended for fulfilling it 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 a page of active, valid listings for a single collection, with cursor pagination.

Get all offers by collection

Get a page of active, valid offers for a collection, including individual and criteria offers, with cursor pagination.

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 offer for an NFT in a collection.

Get collection

Get a single collection by slug, including details such as fees 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 a page of active, valid listings, with optional filters and a cursor for pagination.

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 payment token information for a given chain and token contract 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/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

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

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["open_sea"],
  mcp: true,
});
Create a session scoped to Open sea and read its MCP URL and headers
3

Connect your agent to the MCP server

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

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all active NFT listings for the Bored Ape Yacht Club collection",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Open sea request
SETUP GUIDE

Connect Open sea API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

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

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["open_sea"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Open sea
3

Run Open sea tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all active NFT listings for the Bored Ape Yacht Club collection" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Open sea tool calls through the session, and print the final answer

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

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

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