MCP

🚧

Beta Access Required

OpenSea MCP is currently in beta. We're gradually onboarding developers to ensure a smooth experience and gather feedback to improve the platform. Request an access token using this form.

What is OpenSea MCP?

OpenSea MCP is a hosted server that gives AI tools secure access to OpenSea's comprehensive NFT marketplace data, token information, and blockchain analytics. It's designed to work seamlessly with popular AI assistants like ChatGPT, Cursor, Claude, and Chorus.

Why use OpenSea MCP?

• Easy setup — Connect through a simple URL configuration
• Real-time marketplace data — Access live NFT prices, collections, and token information
• Comprehensive blockchain coverage — Support for Ethereum, Polygon, Base, Solana and other major chains
• Optimized for AI — Built specifically for AI agents with efficient data formatting and natural language search

What can you do with OpenSea MCP?

• Research NFT collections — Get floor prices, volume data, and trending collections across multiple blockchains
• Analyze tokens and cryptocurrencies — Look up ERC-20 tokens, meme coins, and get real-time price data
• Check wallet balances — View NFT holdings and token balances for any wallet address
• Get swap quotes — Calculate token swap prices and gas estimates for DeFi transactions
• Track market trends — Identify trending NFT collections and monitor trading activity
• Search marketplace data — Use AI-powered search to find specific NFTs, collections, or tokens

Getting Started

Connect through your AI tool

To connect OpenSea MCP to your AI assistant, use one of these connection methods:

Streamable HTTP (Recommended)

• URL: https://mcp.opensea.io/mcp
• JSON config:

{
    "mcpServers": {
      "OpenSea": {
        "url": "https://mcp.opensea.io/mcp",
         "headers": {
           "Authorization": "Bearer ACCESS_TOKEN"
         }
      }
    }
}

If your client does not support custom headers, the access token can be provided in-line:

https://mcp.opensea.io/ACCESS_TOKEN/mcp

SSE (Server-Sent Events)

• URL: https://mcp.opensea.io/sse
• JSON config:

{
    "mcpServers": {
      "OpenSea": {
        "url": "https://mcp.opensea.io/sse",
        "headers": {
          "Authorization": "Bearer ACCESS_TOKEN"
        }
      }
    }
}

If your client does not support custom headers, the access token can be provided in-line:

https://mcp.opensea.io/ACCESS_TOKEN/sse

Request an Access Token here

Quick Start Examples

Once connected, try these prompts to explore OpenSea MCP capabilities:

1. "What's the floor price of Bored Ape Yacht Club?"
2. "Show me trending NFT collections on Ethereum"
3. "Get information about the BONK token on Solana"
4. "Check the NFT balance for wallet 0x123..."
5. "Find NFT collections related to gaming"

Sample Project

Prefer a working app? Try the Next.js + Vercel AI SDK starter preconfigured with OpenSea MCP:
https://github.com/ProjectOpenSea/opensea-mcp-next-sample

Supported Tools

Now that you have installed the OpenSea MCP, let's explore how AI assistants can use OpenSea MCP tools to search, analyze, and interact with blockchain and marketplace data.

These tools work seamlessly together through prompts, and their real power comes from combining them. With a single prompt, you can search for collections, check token prices, analyze wallet holdings, and get swap quotes across multiple blockchains.

Common Use Cases

Market Research:

"What are the top gaming NFT collections by volume on Polygon?"

Portfolio Analysis:

"Show me all NFTs and tokens owned by wallet 0x123... and calculate total portfolio value"

Trading Preparation:

"Check if I have enough USDC to buy this NFT and calculate the swap from ETH if needed"

Trend Monitoring:

"Find NFT collections that are trending in the last 24 hours with floor price under 1 ETH"

Token Discovery:

"Search for new meme coins on Ethereum and show their current prices"

Chain Support

OpenSea MCP supports all of the blockchains supported on the OpenSea web front-end.

When using tools, you can specify the chain parameter to filter results to a specific blockchain.

Best Practices

1. Use natural language - The AI-powered search understands context, so describe what you're looking for naturally
2. Combine tools - Get comprehensive insights by using multiple tools together
3. Specify chains - When looking for specific blockchain data, include the chain name
4. Check balances first - Before requesting swap quotes, verify wallet has sufficient tokens
5. Use collection slugs - For specific collections, use their OpenSea slug (e.g., 'boredapeyachtclub')
6. Leverage includes parameters - Many tools support optional 'includes' arrays for additional data (activity, analytics, offers, etc.)
7. Specify amounts correctly - For swaps, use native units (ETH/SOL) not smallest units (wei/lamports)

Rate Limits and Performance

• Most queries return results within 1-3 seconds
• Rate limits apply per access token
• Use pagination for large result sets
• Cursor-based pagination available for trending and top collections/tokens

Error Handling

The MCP server provides clear error messages:

• Invalid addresses or contract addresses
• Unsupported chains
• Rate limit exceeded
• Insufficient token balance for swaps

For questions, feedback or support, contact [email protected].

Request an access token here.