thememesexchange
Milestone 1 · read-only

Agent API

Read the market before you act.

Connect an agent to public 6529 collection, card, listing, season, and collector data. The first planning workflow helps a collector explore how to complete a Memes season within a chosen budget.

Connect your agent OpenAPI specification

Built-in boundaries

  • No API key or wallet connection required
  • Read-only data and planning operations
  • No signing, purchasing, bidding, or execution
  • Machine-readable schemas derived from runtime validation

Connect your agent

One public endpoint, no credentials.

Use the MCP endpoint in a compatible client, or generate a REST client from the OpenAPI document. Client configuration formats differ, so consult your client's MCP setup guide.

MCP

https://thememes.exchange/mcp

Use this URL as the remote MCP server endpoint. Authentication is not required for the milestone 1 read-only tools.

MCP documentation

REST and OpenAPI 3.1

GET https://thememes.exchange/api/v1/capabilities
GET https://thememes.exchange/openapi.json

REST operations use GET, return JSON, support CORS preflight, and include a request ID for tracing.

OpenAPI 3.1 specification

REST surface

Seven focused operations

llms.txt
GET/api/v1/capabilities

Platform capabilities

Discover the public operations, boundaries, and current service limits.

GET/api/v1/collections

Collections

List the 6529 collections covered by this milestone.

GET/api/v1/seasons

Seasons

Browse The Memes season directory and published-card coverage.

GET/api/v1/cards

Cards

Search published card metadata with collection and season filters.

GET/api/v1/listings

Market listings

Read MemesEx-native records with currency and exact raw total ask in wei; do not assume a one-copy quantity.

GET/api/v1/collectors/{identifier}

Collector

Resolve a wallet or supported identity and inspect public holdings.

GET/api/v1/plans/season-completion

Season completion plan

Build an indicative, budget-aware plan from current observed data.

First workflow

“Complete my season within my budget.”

The planner turns public holdings and observed asks into an indicative route through a Memes season. It reports what the current inputs support and keeps uncertainty visible.

01

Resolve the collector

Start with a wallet address or supported identity and load its public holdings.

02

Find missing cards

Compare the holdings with the published cards in the selected Memes season.

03

Respect the budget

Set aside the reserve you chose, then rank observed ETH and WETH asks within the remaining budget.

04

Review the plan

Receive an indicative plan with gaps and warnings. Nothing is signed, purchased, or executed.

Interpret plans carefully

  • Plans cover published cards only.
  • Source update time can be unavailable, so freshness may be unknown.
  • The listings endpoint preserves currency and exact raw total ask; its records do not guarantee a one-copy quantity.
  • Only the planner treats its observed ETH and WETH asks as ETH-equivalent when selecting cards.
  • The reserve is supplied by the user for gas and fees; it is not a gas estimate.
  • Incomplete or unavailable data is reported rather than silently inferred.