| name | opensea-mcp |
| description | Query OpenSea NFT marketplace data via official MCP server. Get floor prices, trending collections, token prices, wallet balances, swap quotes, and NFT holdings. Supports Ethereum, Base, Polygon, Solana, and other major chains. Requires OpenSea developer account for MCP token. Use when this capability is needed. |
| metadata | {"author":"demerzels-lab"} |
OpenSea MCP
Access OpenSea's NFT marketplace data via the official hosted MCP server.
Setup
1. Get MCP Token
- Sign in to opensea.io
- Go to Settings → Developer
- Copy your MCP token
2. Add to Environment
OPENSEA_MCP_TOKEN=your_token_here
3. Configure mcporter
Add to config/mcporter.json:
{
"mcpServers": {
"opensea": {
"baseUrl": "https://mcp.opensea.io/mcp",
"description": "OpenSea NFT Data API",
"headers": {
"Authorization": "Bearer ${OPENSEA_MCP_TOKEN}"
}
}
}
}
4. Test
mcporter list opensea
mcporter call 'opensea.search(query: "trending NFT collections")'
Available Tools
| Tool | Description | Example |
|---|
search | AI-powered search across OpenSea | search(query: "Pudgy Penguins") |
get_collections | Collection details, floor, stats | get_collections(slugs: ["pudgypenguins"]) |
search_collections | Find collections by name | search_collections(query: "azuki") |
get_items | NFT item details | get_items(ids: ["..."]) |
search_items | Find individual NFTs | search_items(query: "Bored Ape #1234") |
get_tokens | Token/coin prices | get_tokens(symbols: ["WETH"]) |
search_tokens | Find tokens | search_tokens(query: "PEPE") |
get_token_swap_quote | Swap quotes with gas | get_token_swap_quote(...) |
get_token_balances | Wallet token holdings | get_token_balances(address: "0x...") |
get_nft_balances | Wallet NFT holdings | get_nft_balances(address: "vitalik.eth") |
Usage Examples
Get Floor Prices
mcporter call 'opensea.get_collections(slugs: ["pudgypenguins", "azuki", "boredapeyachtclub"])'
Search Trending
mcporter call 'opensea.search(query: "trending NFT collections this week")'
Check Wallet NFTs
mcporter call 'opensea.get_nft_balances(address: "vitalik.eth")'
Token Prices
mcporter call 'opensea.get_tokens(symbols: ["ETH", "WETH", "USDC"])'
Swap Quote
mcporter call 'opensea.get_token_swap_quote(from: "ETH", to: "USDC", amount: "1")'
Supported Chains
Ethereum, Base, Polygon, Solana, Arbitrum, Optimism, Avalanche, BNB Chain, Klaytn
Resources
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
