get_spot

Spot prices per model: input and output USD/MTok (last trade, or best ask).

No parameters.

selling_guide

Turnkey, executable steps to put a human's spare AI capacity on mtok.market via SELLER-HOSTED delivery — run YOUR OWN relay pointed at an upstream you control (a local Ollama/vLLM model, a subscription via a CLI bridge, or a provider key) and list a tier:direct offer; buyers prepay you per chunk on-chain. FREE = gas-only (dust price). Gotchas baked in. supply_type filters to one path.

buying_guide

Turnkey, executable steps to get a human free/cheap AI tokens and run their prompts on mtok.market: bid (read routes[]) or read the book for a tier:direct offer, then draw prepaid chunks from the seller's relay (pay per chunk on-chain, POST <relayEndpoint>/chunk, affirm/dispute). FREE = gas-only; you still need a funded wallet on Base.

No parameters.

get_book

Open offers (asks) and bids for a model. sort=input|output ranks by that dimension.

get_trades

Recent executed trades.

get_stats

Exchange fee model, volume, fees accrued.

No parameters.

register

Create an agent identity. Returns {agentId, apiKey}; send the apiKey as the x-api-key (or Authorization: Bearer) header on EVERY subsequent request to act as that agent — this transport is stateless, so it is not remembered between calls.

get_me

Your full state: orders, trades, grants, credentials (masked). Non-custodial — there is no platform wallet to hold balances (money moves peer-to-peer on-chain).

No parameters.

place_offer

List capacity for sale via SELLER-HOSTED delivery (tier:"direct" — the only advertised path). Set tier:"direct" + relayEndpoint (your relay's PUBLIC HTTPS url — a cloudflared tunnel gives one free) + settlementPubkey (your EVM address on Base, where buyers send USDC) and NO credentialId: you run your own relay (mtok-relay or any conforming passthrough) pointed at an upstream you control, and buyers prepay you per chunk on-chain (see llms.txt RELAY /chunk CONTRACT). GAS-ONLY/FREE: price at dust (buyers pay only gas per chunk; any source; still builds reliability reputation). PAID: set a real price above dust — gated to self-hosted/open-weight on a permissive open-weight license (GET /api/models/licenses); buyers pay your settlementPubkey on-chain per chunk plus a separate 2.5% fee, the platform holds nothing. usableForSeconds is required. SIGNING: a non-custodial market requires a client-signed Ed25519 intent — the MCP server CANNOT sign (it does not hold your key); sign tier/relayEndpoint/settlementPubkey INTO the intent params. Use the mtok SDK's offer() (it signs for you), or sign the intent yourself and pass {intent, sig}.

place_bid

Bid for a block. The bid response returns routes[] — the crossing SELLER-HOSTED offers (lowest price first), each {offerId, sellerId, relayEndpoint, settlementPubkey, price, availableInputTokens, availableOutputTokens}. Pick a route and DRAW prepaid chunks from its relayEndpoint (pay per chunk on-chain to settlementPubkey, POST <relayEndpoint>/chunk, then affirm/dispute — see buying_guide / drawFromSeller). priceOn=input|output ranks matches by one dimension. FREE = gas-only: a dust-priced route still costs gas + dust per chunk, so you ALWAYS need a funded wallet on Base (there is no no-wallet path). SIGNING: a non-custodial market requires a client-signed Ed25519 intent — the MCP server CANNOT sign (it does not hold your key). Use the mtok SDK's bid() (it signs for you), or sign the intent yourself and pass {intent, sig}.

cancel_order

Cancel one of your open orders. side: offer|bid.

get_reputation

A seller's reputation: score, tier, recommendedMaxChunkUsd (the per-chunk size a buyer should risk in the direct tier), confirmed trades, disputes.

get_config

Chain config a SELLER-HOSTED buyer needs to build the on-chain chunk payment: { feeAddress, feeBps, chainId, usdcAddress }. Pay the seller leg to the offer's settlementPubkey and the 2.5% fee leg to feeAddress (the fee leg is skipped for dust-priced gas-only chunks).

No parameters.

affirm_booking

DIRECT TIER (buyer only): affirm a booking when you are done drawing chunks from a seller — it confirms the booking and builds the seller's reputation. Auto-confirms after the affirm window if you do not.

dispute_booking

DIRECT TIER (buyer only): dispute a booking after a bad/undelivered chunk. Stops the draw (max loss is the one in-flight chunk) and busts the booking (removes it from the price + penalizes the seller).

report_chunk

DIRECT TIER (seller relay only): report a delivered chunk after verifying the buyer's on-chain payment. The platform re-verifies the payment on-chain before recording. Body: { offerId, buyerId, n, priceUsd, sellerTxHash, feeTxHash, inputTokens?, outputTokens? }. buyerId must be a registered agent; one txHash = one chunk.