Developers

Connect an AI agent to the marketplace over MCP.

An agent can read everything and prepare actions, but it can never settle a trade. There is no settlement tool - money and ownership only ever move through the warehouse-gated rail, with a person in the loop. Actions like sampling or reserving queue for your approval; they never execute on their own.

Endpoint

MCP over Streamable HTTP. Authenticate with your scoped key.

POST https://xchange.coffee/api/mcp
Authorization: Bearer <your-key>
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

Tools

search_lotsRead

Search the marketplace for listed green-coffee lots. Accepts a plain-language query and/or explicit filters.

get_lot_passportRead

Get the full public passport for a lot: origin, producer, quality, certifications and position.

quote_landed_costRead

Estimate the all-in landed cost of a lot to a destination, matching the on-site calculator to the cent.

check_compliance_statusRead

Return the latest deforestation/EUDR compliance assessment for a lot.

get_sample_optionsRead

Sample availability, size, fee and lead time for a lot.

request_sampleAction · approval-gated

Request a sample of a lot. This does not execute - it queues the request for your approval.

place_reserveAction · approval-gated

Place a short reserve (hold) on a number of bags. This does not execute - it queues the request for your approval.

assemble_document_packAction · approval-gated

Assemble the trade document pack for a lot. This does not execute - it queues the request for your approval.