# Opensea MCP

> 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.

- Skill: `tomevault-io/opensea-mcp` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/opensea-mcp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/opensea-mcp/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/opensea-mcp

---


# OpenSea MCP

Access OpenSea's NFT marketplace data via the official hosted MCP server.

## Setup

### 1. Get MCP Token

1. Sign in to [opensea.io](https://opensea.io)
2. Go to [Settings → Developer](https://opensea.io/account/settings/developer)
3. Copy your MCP token

### 2. Add to Environment

```bash
# Add to ~/.openclaw/.env or export
OPENSEA_MCP_TOKEN=your_token_here
```

### 3. Configure mcporter

Add to `config/mcporter.json`:

```json
{
  "mcpServers": {
    "opensea": {
      "baseUrl": "https://mcp.opensea.io/mcp",
      "description": "OpenSea NFT Data API",
      "headers": {
        "Authorization": "Bearer ${OPENSEA_MCP_TOKEN}"
      }
    }
  }
}
```

### 4. Test

```bash
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

```bash
mcporter call 'opensea.get_collections(slugs: ["pudgypenguins", "azuki", "boredapeyachtclub"])'
```

### Search Trending

```bash
mcporter call 'opensea.search(query: "trending NFT collections this week")'
```

### Check Wallet NFTs

```bash
mcporter call 'opensea.get_nft_balances(address: "vitalik.eth")'
```

### Token Prices

```bash
mcporter call 'opensea.get_tokens(symbols: ["ETH", "WETH", "USDC"])'
```

### Swap Quote

```bash
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

- [OpenSea MCP Docs](https://docs.opensea.io/docs/mcp)
- [Developer Portal](https://opensea.io/account/settings/developer)
- [Sample App](https://github.com/ProjectOpenSea/opensea-mcp-next-sample)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/demerzels-lab) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->