`list_collection_nfts`

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

List NFTs inside a collection (paginated). Returns identifier, name, image, traits, owner, last sale.

Parameters

Name	Type	Required	Description
`collection_slug`	string	yes	OpenSea collection slug
`limit`	number	no	1-200 (default 50)
`next`	string	no	Pagination cursor from prior response

Example call

Arguments

{
  "collection_slug": "boredapeyachtclub",
  "limit": 50
}

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":"list_collection_nfts","arguments":{"collection_slug":"boredapeyachtclub","limit":50}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('list_collection_nfts', {
  "collection_slug": "boredapeyachtclub",
  "limit": 50
});

More examples

{
  "collection_slug": "cryptopunks",
  "limit": 100,
  "next": "eyJvZmZzZXQiOiAxMDB9"
}

Response shape

Always returns: collection_slug, count, next, nfts

Field	Type	Description
`collection_slug`	string	Collection slug queried
`count`	number	Number of NFTs in this page
`next`	string \| null	Pagination cursor for next page
`nfts`	array	NFTs in collection

Full JSON Schema

{
  "type": "object",
  "properties": {
    "collection_slug": {
      "type": "string",
      "description": "Collection slug queried"
    },
    "count": {
      "type": "number",
      "description": "Number of NFTs in this page"
    },
    "next": {
      "type": [
        "string",
        "null"
      ],
      "description": "Pagination cursor for next page"
    },
    "nfts": {
      "type": "array",
      "description": "NFTs in collection",
      "items": {
        "type": "object",
        "properties": {
          "identifier": {
            "type": [
              "string",
              "null"
            ],
            "description": "Token ID"
          },
          "collection": {
            "type": [
              "string",
              "null"
            ],
            "description": "Collection slug"
          },
          "contract": {
            "type": [
              "string",
              "null"
            ],
            "description": "Contract address"
          },
          "standard": {
            "type": [
              "string",
              "null"
            ],
            "description": "Token standard (ERC721, ERC1155)"
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "NFT name"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "NFT description"
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "description": "Display image URL"
          },
          "animation": {
            "type": [
              "string",
              "null"
            ],
            "description": "Animation/video URL"
          },
          "metadata_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Metadata URL"
          },
          "opensea_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "OpenSea item page URL"
          },
          "updated_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "Last update timestamp"
          },
          "disabled": {
            "type": "boolean",
            "description": "Whether NFT is disabled"
          },
          "nsfw": {
            "type": "boolean",
            "description": "Whether NFT is marked NSFW"
          },
          "traits": {
            "type": "array",
            "description": "NFT traits/attributes",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Trait name"
                },
                "value": {
                  "type": [
                    "string",
                    "number",
                    "null"
                  ],
                  "description": "Trait value"
                },
                "display_type": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Display type hint"
                }
              }
            }
          },
          "owners": {
            "type": "array",
            "description": "Current owners (for ERC1155 multiple owners possible)",
            "items": {
              "type": "object",
              "properties": {
                "address": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Owner address"
                },
                "quantity": {
                  "type": "number",
                  "description": "Quantity owned"
                }
              }
            }
          },
          "rarity_rank": {
            "type": [
              "number",
              "null"
            ],
            "description": "Rarity rank in collection"
          },
          "rarity_score": {
            "type": [
              "number",
              "null"
            ],
            "description": "Rarity score"
          }
        }
      }
    }
  },
  "required": [
    "collection_slug",
    "count",
    "next",
    "nfts"
  ]
}

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.

list_collection_nfts