Skip to main content
Glama
Crawlora-org

Crawlora MCP

Official

opensea_collection_items

Fetch paginated NFT items from an OpenSea collection, including traits, rarity rank, owner, listing price, and last sale. Filter by traits, price, rarity, or listed-only status.

Instructions

List items in an OpenSea collection. Returns a cursor-paginated page of NFTs in a collection with their traits, rarity rank, current owner, best standing listing, and last sale price. Pass cursor from next_page_cursor to page forward. Narrow the result set with listed_only, traits, a min_price/max_price band, or a min_rarity/max_rarity rank band — the filters combine, so traits=Fur:Solid Gold&listed_only=true returns only buyable Solid Gold apes.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
slugYesOpenSea collection slug
limitNoItems per page, 1-100
cursorNoOpaque pagination cursor from a previous next_page_cursor
traitsNoComma-separated trait_type:value pairs
sort_byNoSort field
max_priceNoMaximum listing price in the collection's native token
min_priceNoMinimum listing price in the collection's native token
max_rarityNoMaximum rarity rank
min_rarityNoMinimum rarity rank (1 is rarest)
listed_onlyNoOnly return items with a standing listing
sort_directionNoSort direction

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv1.17.5
    • addedInput schema / properties / sort_by / enum
      Added value: +[
      +  "PRICE",
      +  "LAST_SALE_DATE",
      +  "RARITY",
      +  "CREATED_DATE"
      +]
    • addedInput schema / properties / sort_direction / enum
      Added value: +[
      +  "ASC",
      +  "DESC"
      +]
  2. Addedv1.16.2

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full behavioral disclosure burden. It discloses cursor-paginated behavior, returned fields, and filter combination semantics. It omits rate limits, error conditions, and authentication needs, but those are less critical for a read-style list operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three dense sentences, each earning its place: purpose and return shape, pagination instruction, then filter behavior with an example. The description is front-loaded and contains no filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description plus fully-documented schema covers required input, return contents, pagination, and filtering. No output schema exists, but the field list gives a solid picture of the response. It doesn't address sort_by semantics or failure cases, which are either in the schema or non-essential.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds meaningful semantics beyond the schema by explaining cursor usage and demonstrating combined filtering with a concrete example ('traits=Fur:Solid Gold&listed_only=true'). This materially helps an agent construct correct queries.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb ('List') and resource ('items in an OpenSea collection'), then enumerates the page contents: traits, rarity rank, current owner, best listing, and last sale price. This clearly differentiates the general collection-listing tool from more specialized siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides explicit pagination guidance ('Pass cursor from next_page_cursor to page forward') and explains how filters combine with a concrete example. It does not name alternative sibling tools such as opensea_collection_rarest_items or opensea_collection_best_deals, so it stops short of a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools