`get_collection`

Pack: opensea · Endpoint: https://gateway.pipeworx.io/opensea/mcp

Fetch a collection by OpenSea slug. Returns name, description, contracts, social links, fees, image, banner. Find slugs at opensea.io/collection/.

Parameters

Name	Type	Required	Description
`collection_slug`	string	yes	OpenSea collection slug (URL suffix)

Example call

Arguments

{
  "collection_slug": "cryptopunks"
}

curl

curl -X POST https://gateway.pipeworx.io/opensea/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_collection","arguments":{"collection_slug":"cryptopunks"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_collection', {
  "collection_slug": "cryptopunks"
});

More examples

{
  "collection_slug": "boredapeyachtclub"
}

Response shape

Always returns: slug, name, description, image, banner, owner, safelist_status, category, disabled, nsfw, opensea_url, website, wiki, discord, telegram, twitter, instagram, contracts, total_supply, fees

Field	Type	Description
`slug`	string	Collection slug identifier
`name`	string \| null	Collection name
`description`	string \| null	Collection description
`image`	string \| null	Collection image URL
`banner`	string \| null	Collection banner image URL
`owner`	string \| null	Collection owner address
`safelist_status`	string \| null	OpenSea safelist verification status
`category`	string \| null	Collection category
`disabled`	boolean	Whether collection is disabled
`nsfw`	boolean	Whether collection is marked NSFW
`opensea_url`	string	OpenSea collection page URL
`website`	string \| null	Project website URL
`wiki`	string \| null	Wiki URL
`discord`	string \| null	Discord server URL
`telegram`	string \| null	Telegram group URL
`twitter`	string \| null	Twitter username
`instagram`	string \| null	Instagram username
`contracts`	array	Smart contracts associated with collection
`total_supply`	number \| null	Total token supply
`fees`	array	Collection fees

Full JSON Schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Collection slug identifier"
    },
    "name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Collection name"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Collection description"
    },
    "image": {
      "type": [
        "string",
        "null"
      ],
      "description": "Collection image URL"
    },
    "banner": {
      "type": [
        "string",
        "null"
      ],
      "description": "Collection banner image URL"
    },
    "owner": {
      "type": [
        "string",
        "null"
      ],
      "description": "Collection owner address"
    },
    "safelist_status": {
      "type": [
        "string",
        "null"
      ],
      "description": "OpenSea safelist verification status"
    },
    "category": {
      "type": [
        "string",
        "null"
      ],
      "description": "Collection category"
    },
    "disabled": {
      "type": "boolean",
      "description": "Whether collection is disabled"
    },
    "nsfw": {
      "type": "boolean",
      "description": "Whether collection is marked NSFW"
    },
    "opensea_url": {
      "type": "string",
      "description": "OpenSea collection page URL"
    },
    "website": {
      "type": [
        "string",
        "null"
      ],
      "description": "Project website URL"
    },
    "wiki": {
      "type": [
        "string",
        "null"
      ],
      "description": "Wiki URL"
    },
    "discord": {
      "type": [
        "string",
        "null"
      ],
      "description": "Discord server URL"
    },
    "telegram": {
      "type": [
        "string",
        "null"
      ],
      "description": "Telegram group URL"
    },
    "twitter": {
      "type": [
        "string",
        "null"
      ],
      "description": "Twitter username"
    },
    "instagram": {
      "type": [
        "string",
        "null"
      ],
      "description": "Instagram username"
    },
    "contracts": {
      "type": "array",
      "description": "Smart contracts associated with collection",
      "items": {
        "type": "object",
        "properties": {
          "address": {
            "type": [
              "string",
              "null"
            ],
            "description": "Contract address"
          },
          "chain": {
            "type": [
              "string",
              "null"
            ],
            "description": "Blockchain chain name"
          }
        }
      }
    },
    "total_supply": {
      "type": [
        "number",
        "null"
      ],
      "description": "Total token supply"
    },
    "fees": {
      "type": "array",
      "description": "Collection fees",
      "items": {
        "type": "object",
        "properties": {
          "pct": {
            "type": [
              "number",
              "null"
            ],
            "description": "Fee percentage"
          },
          "recipient": {
            "type": [
              "string",
              "null"
            ],
            "description": "Fee recipient address"
          },
          "required": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether fee is required"
          }
        }
      }
    }
  },
  "required": [
    "slug",
    "name",
    "description",
    "image",
    "banner",
    "owner",
    "safelist_status",
    "category",
    "disabled",
    "nsfw",
    "opensea_url",
    "website",
    "wiki",
    "discord",
    "telegram",
    "twitter",
    "instagram",
    "contracts",
    "total_supply",
    "fees"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "opensea": {
      "url": "https://gateway.pipeworx.io/opensea/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_collection