# OpenSea — MCP server on mcp.ai
> Connect your OpenSea account and use 24 tools for ecommerce straight from your AI agent. Connect with your own API key. OpenSea is the world's first and largest NFT marketplace for NFTs and crypto collectibles.

By: mcp.ai · official
Page: https://mcp.ai/open_sea

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_open_sea?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/open_sea/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/open_sea/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/open_sea/skill.md
Postman collection (v2.1): https://mcp.ai/open_sea/postman.json

## Tools
- open_sea_build_criteria_offer(offerer: string, criteria: object, quantity?: integer) — Build a portion of a criteria offer including the merkle tree needed to post an offer.
- open_sea_cancel_order(chain: string, order_hash: string, protocol_address: string, offerer_signature?: string) — Offchain cancel a single order, offer or listing, by its order hash when protected by the SignedZone. Protocol and Chain are required to prevent hash collisions. Please note cancellation is only assur
- open_sea_create_criteria_offer(protocol_data: object) — Create a criteria offer to purchase any NFT in a collection or which matches the specified trait.
- open_sea_create_item_offer(chain: string, protocol: string, signature: string, parameters: object, protocol_address: string) — Create an offer to purchase a single NFT (ERC721 or ERC1155).
- open_sea_create_listing(chain: string, protocol: string, signature: string, parameters: object, protocol_address: string) — List a single NFT (ERC721 or ERC1155) for sale on the OpenSea marketplace.
- open_sea_fulfill_listing(listing: object) — Retrieve all the information, including signatures, needed to fulfill a listing directly onchain.
- open_sea_fulfill_offer(offer: object) — Retrieve all the information, including signatures, needed to fulfill an offer directly onchain.
- open_sea_get_account(address_or_username: string) — Get an OpenSea Account Profile including details such as bio, social media usernames, and profile image.
- open_sea_get_all_listings_by_collection(next?: string, limit?: integer, collection_slug: string) — Get all active, valid listings for a single collection.
- open_sea_get_all_offers_by_collection(next?: string, limit?: integer, collection_slug: string) — Get all active, valid offers for the specified collection. This includes individual and criteria offers.
- open_sea_get_best_listing_by_nft(identifier: string, collection_slug: string, include_private_listings?: boolean) — Get the best listing for an NFT.
- open_sea_get_best_listings_by_collection(next?: string, limit?: integer, collection_slug: string, include_private_listings?: boolean) — Get the cheapest priced active, valid listings on a single collection.
- open_sea_get_best_offer_by_nft(identifier: string, collection_slug: string) — Get the best offers for an NFT.
- open_sea_get_collection(collection_slug: string) — Get a single collection including details such as fees, traits, and links.
- open_sea_get_collection_stats(collection_slug: string) — Get stats for a single collection on OpenSea.
- open_sea_get_collections(next?: string, chain?: string, limit?: integer, order_by?: string, include_hidden?: boolean, creator_username?: string) — Get a list of OpenSea collections with optional filtering and pagination.
- open_sea_get_contract(chain: string, address: string) — Get a smart contract for a given chain and address.
- open_sea_get_events(next?: string, after?: integer, limit?: integer, before?: integer, event_type?: string[]) — Get a list of events from OpenSea based on various filters like timestamps and event types.
- open_sea_get_listings(chain: string, limit?: integer, maker?: string, taker?: string, cursor?: string, order_by?: string, protocol: string, token_ids?: integer[], listed_after?: string, listed_before?: string, order_direction?: string, payment_token_address?: string, asset_contract_address?: string) — Get the complete set of active, valid listings.
- open_sea_get_nft(chain: string, address: string, identifier: string) — Get metadata, traits, ownership information, and rarity for a single NFT.
- open_sea_get_order(chain: string, order_hash: string, protocol_address: string) — Get a single order, offer or listing, by its order hash. Protocol and Chain are required to prevent hash collisions.
- open_sea_get_payment_token(chain: string, address: string) — Get a smart contract for a given chain and address.
- open_sea_get_traits(collection_slug: string) — Get the traits in a collection.
- open_sea_refresh_nft_metadata(chain: string, address: string, identifier: string) — Refresh metadata for a single NFT.

## Example prompts
- "What can I do in OpenSea?"
- "Show me a summary of my OpenSea account"

## Links
Docs: https://mcp.ai/docs/mcps/open_sea
Website: https://mcp.ai/mcps/open_sea