Server definition
- Hash
- sha256:6b54daf71b4ea0d84039d0869ea45c7a965c6b54c97e75f0dcc711133c0522db
- What it is
- What a remote MCP server returned when asked what it offers: 15 tools
The blob, as servednamed by its sha256
{
"instructions": "START HERE for RPC (Moonbeam 1284, Moonriver 1285, Moonbase Alpha 1287 and every chain of the gateway): taifoon_rpc_subscribe {} in one call returns your free key, the gateway URL, your allowance and the x402 top-up terms; call it again with payment to credit the key (the prompt subscribe_rpc runs it). START HERE, no payment — the one onboarding flow (the prompt onboard runs it; the same steps: GET https://coord.taifoon.dev/v1/quickstart): (1) taifoon_register {} creates your tenant and returns a free key (tfr_free_…) in one call (no arguments needed; a wallet_address is only an optional label); pass it as api_key or as an X-API-Key header on this server. (2) taifoon_post_demand {\"need\":\"the keccak256 hash of \\\"hello world\\\"\",\"dry_run\":true} shows the match and its terms (seller, price, the Wilson record, cover, premium; from POST /v1/pools/quote); without dry_run it runs as written: the layer picks a seller, hires it, grades the reply by code and settles on the devnet within minutes; follow it with taifoon_demand_status. (3) taifoon_tenant: your cockpit, the job counted, and the next step. Every refusal carries next_step (what to call next, with the price when it costs money): 3 free grades per user, then 0.15 USDC per 3 grades on Base via GET https://coord.taifoon.dev/v1/judge/credits/key (no key needed first). Taifoon — the coordination layer. Source portable V5 proofs of blocks under the superroot (taifoon_superroot lists the chains it includes), read the superroot, browse the skills catalog, register an agent key, and bring a resource (RPC, GPU) to the Grid to earn GRID points from measured probes. Priced skill walls answer HTTP 402 with their terms and settle through the configured x402 facilitator; see taifoon.io/docs/x402-gateway. The orderbook (clob.taifoon.dev, USDG and ETH on Robinhood Chain, spot ETH-USDG): taifoon_orderbook_register (a wallet signature, the key once) → taifoon_orderbook_route → send the transfer from the operator wallet → taifoon_orderbook_deposit → taifoon_orderbook_account → taifoon_orderbook_order → taifoon_orderbook_withdraw (an unsigned plan to the operator wallet only: you sign it with that wallet and send it yourself) → taifoon_orderbook_settlement. Call taifoon_grid_status before taifoon_grid_join. The coordination layer is here too: taifoon_hire_suggest → taifoon_match → taifoon_hire_assemble (the judge assembles the hire on your own typesafe_key) → taifoon_handshake (dispatch:true delivers the offer to the agent in its own protocol and returns its reply + digest) → taifoon_assurance_call (unsigned calls; you sign) → taifoon_hire_attach → taifoon_hire_lifecycle (traced, proven). A seller agent reads its offers with taifoon_offers. Pass api_key (tfr_…) so the free judge calls are yours. Every job that went through the layer, with who did the work and who was paid: taifoon_explorer_jobs. Want to buy a listed agent? taifoon_catalog lists every agent the layer resells with its price, cover and the one call that buys it (taifoon_post_demand { catalog_id }). Need work done without choosing a seller? taifoon_post_demand takes it in plain words; the auto-match loop hires, grades by code and settles it on the devnet (follow it with taifoon_demand_status). New here? taifoon_onboarding_flows lists ready-to-run hires resurfaced from the harvest. Every coordination tool (taifoon_discover, taifoon_match, taifoon_handshake, taifoon_hire, taifoon_grade on your own TypeSafe key, taifoon_settle_plan, taifoon_bridge_plan, taifoon_proof_tx, taifoon_metrics, taifoon_network, taifoon_post_demand, taifoon_demand_status, taifoon_list_demands) is one call through coord.taifoon.dev/v1, counted in /v1/metrics; send X-API-Key: tfr_… on the connection to use your relayer key. Also reachable here: trading tools (Cubicle: strategy forge and rehearsal, CLOB candles, model records, Robinhood vaults), found through capability search (taifoon_discover with q, or GET /v1/capabilities/search?q=). Lineage language: a sale walks offer in → classify → listed → hired → delivered → graded → settled → legs written → accrued → split → PAID → recorded; a venue adapter has offer.in · offer.out · job.in · job.out; the seller of record pays on by forward · share · period · markup; a leg is Owed → Reserved → Sent | Held | Refunded; a hop reads OK · HELD · MISSING · BROKEN. On the wire the hop ids are the event field step and the metric label stage; a wire name is never renamed.",
"tools": [
{
"description": "Reads your tenant, what your key rents and its usage, and runs your reseller side (child keys with your markup, your earnings). For a new key use taifoon_register; for vault money use taifoon_vault. Actions: tenant — your tenant: keys (prefixes), traffic, the next step; access — the products a key rents, each with calls, price and your allowance; topup — LEGACY key balance from a payment (frozen by the top-up policy; vault top-ups replace it); metrics — what went through the layer: calls per route, hires, grades, bridges, fees; reseller_child — resell Taifoon: mint a child key for your customer with your markup (label, markup_bps per product, e.g. { \"*\": 1000 }); every tenant is a reseller, the markup is booked as the reseller_markup leg; reseller_earnings — your children, their calls, what your balance paid at list price, what they owe you (list + markup), your margin.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"default": "tenant",
"description": "what to do (default tenant): tenant | access | topup | metrics | reseller_child | reseller_earnings",
"enum": [
"tenant",
"access",
"topup",
"metrics",
"reseller_child",
"reseller_earnings"
],
"examples": [
"tenant"
],
"type": "string"
},
"api_key": {
"description": "api key (actions: tenant, access, topup, reseller_child, reseller_earnings)",
"type": "string"
},
"chain_id": {
"description": "the pay chain; absent = Base (actions: topup)",
"enum": [
8453,
42161,
5042,
143,
4663
],
"type": "integer"
},
"day": {
"description": "YYYY-MM-DD (UTC) (actions: metrics)",
"type": "string"
},
"label": {
"description": "a label for the child key (your customer) (actions: reseller_child)",
"type": "string"
},
"markup_bps": {
"description": "your markup in basis points per product id, \"*\" for all, e.g. { \"*\": 1000, \"taifoon.rpc\": 2500 } (actions: reseller_child)",
"type": "object"
},
"params": {
"description": "operation parameters, e.g. { \"vault\": \"vault:tenant:tenant-3\" } (actions: reseller_earnings)",
"type": "object"
},
"plan": {
"description": "plan (actions: topup)",
"enum": [
"builder-99",
"team-199",
"protocol-299"
],
"type": "string"
},
"range": {
"description": "range (actions: tenant)",
"enum": [
"1d",
"7d",
"30d",
"90d"
],
"type": "string"
},
"series": {
"description": "series (actions: metrics)",
"maximum": 90,
"minimum": 1,
"type": "integer"
},
"signature": {
"description": "personal_sign of the quoted message by the wallet that sent the transfer (actions: topup)",
"type": "string"
},
"tile": {
"description": "tile (actions: tenant)",
"enum": [
"demand",
"catalog",
"pool",
"rpc",
"proof",
"grade",
"gpu",
"bridge"
],
"type": "string"
},
"tx": {
"description": "the hash of your transfer on that chain (actions: topup)",
"type": "string"
},
"usdc": {
"description": "usdc (actions: topup)",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"view": {
"description": "view (actions: access)",
"enum": [
"products",
"package",
"key",
"usage",
"reseller"
],
"type": "string"
},
"window": {
"description": "window (actions: access)",
"enum": [
"1d",
"7d",
"30d",
"month"
],
"type": "string"
}
},
"type": "object"
},
"name": "taifoon_account",
"outputSchema": null
},
{
"description": "Buys one call of a skill the layer sells per call (x402): the best-ranked seller answers. Without payment it returns the payment terms. For hiring an agent for a job use taifoon_hire. Actions (class ids): mcp.digest, sold per call by Taifoon at 0.0012 USDC (x402); plan.steps, sold per call by Taifoon at 0.0012 USDC (x402); risk.address, sold per call by Taifoon at 0.0012 USDC (x402); agent.directory, sold per call by Taifoon at 0.002 USDC (x402); inference.metered, sold per call by Taifoon at 0.0012 USDC (x402); market.price, sold per call by Taifoon at 0.001714 USDC (x402); mech.predict, sold per call by Taifoon at 0.002586 USDC (x402); tee.typed.compile, sold per call by Taifoon at 0.00122 USDC (x402).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"description": "the class to buy one call of",
"enum": [
"mcp.digest",
"plan.steps",
"risk.address",
"agent.directory",
"inference.metered",
"market.price",
"mech.predict",
"tee.typed.compile"
],
"examples": [
"mcp.digest"
],
"type": "string"
},
"input": {
"description": "the class input (each class lists its example in the action list)",
"type": "object"
},
"payment": {
"description": "optional: the x402 PAYMENT-SIGNATURE header value (base64) for this wall's terms",
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "taifoon_buy",
"outputSchema": null
},
{
"description": "Reads blocks, transactions, logs, accounts and protocol state from the layer's own index and coord RPC. For a proof use taifoon_prove. Actions: lookup — a block, transaction or receipt; logs — event logs like eth_getLogs, paged; account — every event or transaction of an address on one chain; scan — advance and read a scan job; rpc — one JSON-RPC read through the coord RPC gateway; query — one priced on-chain data query on Base (x402); transitions — a protocol's state transitions from the protocol trees; decoders — the protocols the producer decodes; bridge — the exact approve + bridge calls for a USDC transfer across chains.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"default": "lookup",
"description": "what to do (default lookup): lookup | logs | account | scan | rpc | query | transitions | decoders | bridge",
"enum": [
"lookup",
"logs",
"account",
"scan",
"rpc",
"query",
"transitions",
"decoders",
"bridge"
],
"examples": [
"lookup"
],
"type": "string"
},
"address": {
"description": "address (actions: logs, account)",
"type": "string"
},
"amount": {
"description": "amount (actions: bridge)",
"type": "string"
},
"api_key": {
"description": "api key (actions: lookup, logs, account, scan, rpc, transitions)",
"type": "string"
},
"chain": {
"description": "8453 (Base); \"base\" works too (actions: query)",
"type": [
"integer",
"string"
]
},
"chain_id": {
"description": "any chain the layer reads: 8453, 5042, 1, 56, 43114, 42161, 137, 10, 4663, 42220, 36927, 3692781, 999, 99901, 2741, 196, 143, 100 (actions: lookup, logs, account, scan, rpc)",
"type": "integer"
},
"cursor": {
"description": "cursor (actions: logs, account, scan)",
"minimum": 0,
"type": "integer"
},
"dst_chain_id": {
"description": "dst chain id (actions: bridge)",
"type": "integer"
},
"from": {
"description": "from (actions: logs, account)",
"minimum": 0,
"type": "integer"
},
"from_seq": {
"description": "from seq (actions: transitions)",
"minimum": 0,
"type": "integer"
},
"full_proof": {
"description": "add the multiproof itself (actions: lookup)",
"type": "boolean"
},
"id": {
"description": "block: latest | finalized | a number | a block hash; tx and receipt: the 32-byte transaction hash (actions: lookup, scan)",
"type": "string"
},
"key": {
"description": "key (actions: transitions)",
"type": "string"
},
"kind": {
"description": "kind (actions: lookup)",
"enum": [
"block",
"tx",
"receipt"
],
"type": "string"
},
"limit": {
"description": "limit (actions: logs, account, scan, transitions)",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"method": {
"description": "method (actions: rpc)",
"enum": [
"eth_blockNumber",
"eth_call",
"eth_getLogs",
"eth_getBlockByNumber",
"eth_getBlockByHash",
"eth_getTransactionByHash",
"eth_getTransactionReceipt",
"eth_getBlockReceipts",
"eth_getTransactionByBlockNumberAndIndex",
"eth_getBlockTransactionCountByNumber",
"eth_getBlockTransactionCountByHash",
"eth_getBalance",
"eth_getCode",
"eth_getTransactionCount",
"eth_getStorageAt",
"eth_estimateGas",
"eth_gasPrice",
"eth_maxPriorityFeePerGas",
"eth_feeHistory",
"eth_blobBaseFee",
"eth_syncing",
"eth_chainId",
"net_version",
"net_listening",
"web3_clientVersion",
"taifoon_getProof"
],
"type": "string"
},
"params": {
"description": "params (actions: rpc, query)",
"items": {},
"type": "array"
},
"payment": {
"description": "optional: the x402 PAYMENT-SIGNATURE header value (base64) for the terms an unpaid call returns (actions: query)",
"type": "string"
},
"protocol": {
"description": "protocol (actions: transitions)",
"type": "string"
},
"question": {
"description": "question (actions: query)",
"enum": [
"pool_tokens",
"block_hash"
],
"type": "string"
},
"recipient": {
"description": "recipient (actions: bridge)",
"type": "string"
},
"sender": {
"description": "sender (actions: bridge)",
"type": "string"
},
"speed": {
"description": "speed (actions: bridge)",
"enum": [
"standard",
"fast"
],
"type": "string"
},
"src_chain_id": {
"description": "src chain id (actions: bridge)",
"type": "integer"
},
"to": {
"description": "to (actions: logs, account)",
"minimum": 0,
"type": "integer"
},
"topic0": {
"description": "topic0 (actions: logs)",
"type": "string"
},
"topic1": {
"description": "topic1 (actions: logs)",
"type": "string"
},
"topic2": {
"description": "topic2 (actions: logs)",
"type": "string"
},
"topic3": {
"description": "topic3 (actions: logs)",
"type": "string"
},
"txs": {
"description": "block: add the transaction hashes (actions: lookup)",
"type": "boolean"
},
"view": {
"description": "view (actions: account)",
"enum": [
"events",
"txs"
],
"type": "string"
}
},
"type": "object"
},
"name": "taifoon_chain",
"outputSchema": null
},
{
"description": "Posts work in plain words and lets the layer match, hire, grade and settle it; reads demands. For choosing the seller yourself use taifoon_hire. Actions: post — post a need (need, budget); the auto-match loop takes it from there; status — one demand and every step written on it (id); list — demands, newest first, by state; work — the newest demands whose classes match yours (seller side).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"default": "post",
"description": "what to do (default post): post | status | list | work",
"enum": [
"post",
"status",
"list",
"work"
],
"examples": [
"post"
],
"type": "string"
},
"api_key": {
"description": "your relayer key (tfr_…); without one you post as a visitor: 3 a minute, 20 a day (actions: post)",
"type": "string"
},
"buyer_label": {
"description": "a label for yourself, shown on the demand (never verified) (actions: post)",
"type": "string"
},
"catalog_id": {
"description": "buy a taifoon_catalog buy_now entry (cat_ + 16 hex): its seller is hired first, at our price for it unless price_units is sent (actions: post)",
"type": "string"
},
"class": {
"description": "a job class id instead of (or to settle) the words, e.g. mcp.digest, stats.describe, chat.word_count (actions: post)",
"type": "string"
},
"classes": {
"description": "classes (actions: work)",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"dry_run": {
"description": "answer the class and input the words map to; keep nothing (actions: post)",
"type": "boolean"
},
"id": {
"description": "the demand id, dm_ + 24 hex (actions: status)",
"type": "string"
},
"input": {
"description": "the class input, with class (actions: post)",
"type": "object"
},
"limit": {
"description": "limit (actions: list)",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"need": {
"description": "the work in plain words (at most 1,000 characters); quote a text, give numbers as [..], JSON as {..} (actions: post)",
"type": "string"
},
"price_units": {
"description": "the price in dUSDC units (6 decimals; default 50000 = 0.05) (actions: post)",
"type": "string"
},
"since": {
"description": "ISO time: only demands announced after it (actions: work)",
"type": "string"
},
"state": {
"description": "state (actions: list)",
"enum": [
"open",
"claimed",
"matched",
"hired",
"graded",
"settling",
"settled",
"unmatched",
"failed",
"cancelled"
],
"type": "string"
}
},
"type": "object"
},
"name": "taifoon_demand",
"outputSchema": null
},
{
"description": "Finds agents, capabilities and resold skills for a job, ranked. For hiring the one you found use taifoon_hire; for posting a need and letting the layer hire use taifoon_demand. Actions: discover — hireable agents and capabilities for words (q); match — a ranked shortlist for required_skills, with assurance terms; suggest — skills, budget and terms for a task, from live data; catalog — every agent the layer resells: seller price, ours (seller + routing fee), cover; skills — the skills catalog with prices, rails and whether a wall is payable now; seller — one seller before you hire it: classes, venues, price, record; venues — where outside buyers pay for agent work (x402 chains, ACP, ERC-8183); landscape — every agent ecosystem harvested, as one figure; search — one index in plain words (q): agents across markets (vertical:agents, facet venue), classes, venues, operations, programs, strategies; each row with what to read and the next call; outlets — from what you sell (need) to where to list it: the classes, the venues in ranked order, and the series of calls you send yourself; prices — Taifoon Search: what a task class is worth per venue — the ask band, the paid band and the buyer price (the one price rule, _UNDERCUT_v3_: 20 % under the cheapest matching seller, never under (seller + venue fees) × 1.2); query class=, venue=; compare — Taifoon Search: which venue pays most for a class — the sides ranked by paid median, then USD paid; query class= (required); book — Taifoon Search: the market book — every venue's ask and bid per resource, each match priced by the one scheme; query resource=, buy=, sell=, chain=, state= (the edges need a live key); listings — Taifoon Search: the venues an agent should list on, ranked by expected USD a week for its classes, each with the venue's own incentive and the listing's state; path id= (a registered agent) or query classes=a,b for a card not yet registered; flows — ready-to-run hire flows from the harvest; readiness — what one agent still needs to be hireable.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"default": "discover",
"description": "what to do (default discover): discover | match | suggest | catalog | skills | seller | venues | landscape | search | outlets | prices | compare | book | listings | flows | readiness",
"enum": [
"discover",
"match",
"suggest",
"catalog",
"skills",
"seller",
"venues",
"landscape",
"search",
"outlets",
"prices",
"compare",
"book",
"listings",
"flows",
"readiness"
],
"examples": [
"discover"
],
"type": "string"
},
"agent_id": {
"description": "the ERC-8004 agentId (decimal), or a seller address (0x…) (actions: readiness)",
"type": "string"
},
"api_key": {
"description": "api key (actions: suggest, search, outlets, prices, compare, book, listings)",
"type": "string"
},
"budget_usdc": {
"description": "budget usdc (actions: match)",
"type": "number"
},
"chain_id": {
"description": "chain id (actions: suggest, readiness)",
"type": "integer"
},
"class": {
"description": "a job class id, e.g. mcp.digest or proof.verify.v5 (actions: discover, catalog, seller)",
"type": "string"
},
"classes": {
"description": "class ids of the class language, when known (they skip the classify step) (actions: outlets)",
"items": {
"type": "string"
},
"type": "array"
},
"facet": {
"description": "optional: count every match by this attribute before the cut (the answer adds total and facets) (actions: search)",
"enum": [
"venue",
"cohort",
"class",
"vertical"
],
"type": "string"
},
"findings": {
"description": "answer the findings with their records instead of the profile (actions: seller)",
"type": "boolean"
},
"hireable": {
"description": "hireable (actions: discover)",
"type": "boolean"
},
"id": {
"description": "one entry: cat_ + 16 hex (actions: catalog, flows)",
"type": "string"
},
"jev": {
"description": "jev (actions: suggest)",
"type": "boolean"
},
"limit": {
"description": "limit (actions: discover, catalog, seller, flows)",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"mode": {
"description": "default hybrid: words and meaning fused (actions: search)",
"enum": [
"hybrid",
"text",
"vector"
],
"type": "string"
},
"need": {
"description": "what you sell, in plain words (or send classes) (actions: outlets)",
"type": "string"
},
"offset": {
"description": "offset (actions: catalog)",
"minimum": 0,
"type": "integer"
},
"params": {
"description": "operation parameters, e.g. { \"vault\": \"vault:tenant:tenant-3\" } (actions: prices, compare, book, listings)",
"type": "object"
},
"price_usd": {
"description": "the seller's own price per call in USD (actions: outlets)",
"minimum": 0,
"type": "number"
},
"protocol": {
"description": "mcp, a2a, uagents, n8n, x402 (actions: catalog)",
"type": "string"
},
"q": {
"description": "words for the work, e.g. \"market data\", \"copy trading\", \"strategy backtest\" (actions: discover, catalog, search)",
"type": "string"
},
"required_skills": {
"description": "required skills (actions: match)",
"items": {
"type": "string"
},
"type": "array"
},
"seller": {
"description": "0x… seller (optional) (actions: suggest, seller)",
"type": "string"
},
"skill": {
"description": "skill (actions: flows)",
"type": "string"
},
"source": {
"description": "source (actions: flows)",
"enum": [
"hireable-agent",
"settled-job",
"registered-n8n"
],
"type": "string"
},
"state": {
"description": "state (actions: seller)",
"enum": [
"clean",
"findings",
"parked",
"unchecked"
],
"type": "string"
},
"status": {
"description": "status (actions: catalog, skills)",
"enum": [
"buy_now",
"priced",
"quote_on_request",
"covered",
"openable",
"ready",
"served"
],
"type": "string"
},
"summary": {
"description": "summary (actions: readiness)",
"type": "boolean"
},
"task": {
"description": "task (actions: match, suggest)",
"type": "string"
},
"tenant": {
"description": "tenant (actions: readiness)",
"enum": [
"moonbeam",
"taifoon"
],
"type": "string"
},
"top": {
"description": "rows to return (default 10) (actions: search)",
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"typesafe_key": {
"description": "typesafe key (actions: suggest)",
"type": "string"
},
"venue": {
"description": "a venue id (x402-base, x402-solana, x402-arbitrum, x402-robinhood, x402-monad, memoacp-base, erc8183-base, bitagent-base) or a marketplace id (actions: venues, outlets)",
"type": "string"
},
"vertical": {
"description": "one vertical or several, comma-separated: classes, venues, agents, ops, programs, strategies; markets and routes with a key (actions: search)",
"type": "string"
}
},
"type": "object"
},
"name": "taifoon_find",
"outputSchema": null
},
{
"description": "Grades work with calibrated answers on your own TypeSafe key, and reads the judge's decisions. For proving a chain fact use taifoon_prove. Actions: grade — up to 4 items in one calibrated call; compose — the release rubric: code proves the facts, the judge answers four questions; ref — one question about an item, with value, probabilities and confidence; decisions — every decision the judge made, with its recomputable digest.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"default": "grade",
"description": "what to do (default grade): grade | compose | ref | decisions",
"enum": [
"grade",
"compose",
"ref",
"decisions"
],
"examples": [
"grade"
],
"type": "string"
},
"answered_by": {
"description": "answered by (actions: compose)",
"enum": [
"n8n-typesafe"
],
"type": "string"
},
"answers": {
"description": "mode answers: id → { value, confidence, probabilities } for each of the four questions prepare returned (actions: compose)",
"type": "object"
},
"api_key": {
"description": "api key (actions: grade, compose, ref)",
"type": "string"
},
"chain_id": {
"description": "chain id (actions: compose)",
"type": "integer"
},
"execution_id": {
"description": "execution id (actions: compose)",
"type": "string"
},
"handshake_id": {
"description": "handshake id (actions: compose)",
"type": "string"
},
"id": {
"description": "one decision id, for its full record and calldata (actions: decisions)",
"type": "string"
},
"items": {
"description": "items (actions: grade)",
"items": {
"type": "object"
},
"type": "array"
},
"job_id": {
"description": "job id (actions: compose)",
"type": "string"
},
"kind": {
"description": "kind (actions: decisions)",
"enum": [
"pad",
"suggest",
"assemble",
"ref",
"grade",
"study"
],
"type": "string"
},
"limit": {
"description": "limit (actions: decisions)",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"mode": {
"description": "mode (actions: compose)",
"enum": [
"single",
"prepare",
"answers"
],
"type": "string"
},
"model": {
"description": "model (actions: compose)",
"type": "string"
},
"olas": {
"description": "olas (actions: compose)",
"type": "string"
},
"options": {
"description": "options (actions: grade, ref)",
"items": {
"type": "string"
},
"type": "array"
},
"prepare_digest": {
"description": "prepare digest (actions: compose)",
"type": "string"
},
"price_usdc": {
"description": "price usdc (actions: compose)",
"type": "number"
},
"question": {
"description": "question (actions: grade, ref)",
"type": "string"
},
"record": {
"description": "where the decision and its answers are also written on chain: none (default: receipt and digests only), devnet (free), base, or the name or chain id of any live network, or a list of them; GET /v1/judge/record/networks lists the live networks with the price of a record now. The caller pays a record on any network but the devnet: a key is debited in bought grades (402 record_needs_balance with the price when it has none); with no key the answer is 402 with the x402 challenge, itemised (grade, record, network). A network that is not live answers 400 record_network_not_live with the live ones (actions: compose)",
"items": {
"type": [
"string",
"integer"
]
},
"type": [
"string",
"integer",
"array"
]
},
"state": {
"description": "state (actions: compose, ref)",
"type": "string"
},
"trading": {
"description": "a trading epoch to grade: { mandate: { markets[], venues[], period { from, to }, max_order_size, max_notional, max_position, allow_short?, kind?, owner?, attribution? }, evidence: [{ kind: clob-fills | hyperliquid-userfills | vault-events | owner-signed-export, venue, items[] }], settlement?, stepper?, submitted? }; code runs the class checks (each kind's reader verifies what it can), then Jev answers over those facts (actions: compose)",
"type": "object"
},
"typesafe_key": {
"description": "typesafe key (actions: grade, compose, ref)",
"type": "string"
}
},
"type": "object"
},
"name": "taifoon_grade",
"outputSchema": null
},
{
"description": "Buys and sells measured compute and RPC on the Taifoon Grid: AI, GPU and TEE calls, hiring resources, joining with your own, earnings. For agent work use taifoon_find and taifoon_hire. Actions: status — what the Grid accepts and pays now, per resource kind; ai — one AI call on a node measured for that model; gpu — one inference through the metered GPU gate, with your key; tee — compile rules into typed questions inside an enclave; hire — usable providers of a kind with endpoints and a quote; join — bring a resource and earn GRID from measured probes; builders — join the Early Builder Program whitelist: get the message, sign it, send it; pool — where the Grid is short and what each kind pays; prices — every operation priced in and out in GRID; economics — what the Grid earns, per kind and attribution; settlement — a wallet's Grid ledger and what was minted; avenues — the outlets where Taifoon resells community capacity; shards — how the MMR splits across collectors; node — the docker command that runs taifoon-node for a wallet; bench — the one-line benchmark for a machine and its earnings.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"default": "status",
"description": "what to do (default status): status | ai | gpu | tee | hire | join | builders | pool | prices | economics | settlement | avenues | shards | node | bench",
"enum": [
"status",
"ai",
"gpu",
"tee",
"hire",
"join",
"builders",
"pool",
"prices",
"economics",
"settlement",
"avenues",
"shards",
"node",
"bench"
],
"examples": [
"status"
],
"type": "string"
},
"agent": {
"description": "kind=agent: erc8004:<chain>:<id>, or the https URL of the agent card (actions: builders)",
"type": "string"
},
"api_key": {
"description": "api key (actions: gpu, tee, hire, join)",
"type": "string"
},
"body": {
"description": "body (actions: gpu)",
"type": "object"
},
"chain_id": {
"description": "settlement chain (default 8453, Base — where the assurance contract is live) (actions: ai, join)",
"type": "integer"
},
"collectors": {
"description": "plan for this many collectors instead of the live swarm (actions: shards)",
"maximum": 1024,
"minimum": 1,
"type": "integer"
},
"compose": {
"description": "provision/quote: an allowlisted compose id (taifoon-tee-seller) or its file’s sha256; absent = the first on the allowlist (actions: tee)",
"type": "string"
},
"day": {
"description": "YYYYMMDD (UTC); default today (actions: economics)",
"type": "string"
},
"endpoint": {
"description": "endpoint (actions: gpu, join, builders, node)",
"enum": [
"chat",
"generate",
"route"
],
"type": "string"
},
"expiry": {
"description": "expiry (actions: builders)",
"type": "integer"
},
"gpus": {
"description": "number of cards (default 1) (actions: bench)",
"maximum": 64,
"minimum": 0,
"type": "integer"
},
"group": {
"description": "group (actions: prices)",
"enum": [
"grid",
"chain",
"mmr",
"ai",
"hosting",
"bridge",
"skill",
"coordination",
"agents"
],
"type": "string"
},
"hirer": {
"description": "optional 0x wallet; records the intent in the Grid ledger (actions: ai, hire)",
"type": "string"
},
"hours": {
"description": "hours (actions: tee, hire)",
"maximum": 720,
"minimum": 1,
"type": "integer"
},
"id": {
"description": "status/release: the enclave id (enc_…) (actions: tee, avenues)",
"type": "string"
},
"kind": {
"description": "kind (actions: hire, join, builders, node)",
"enum": [
"rpc",
"gpu",
"fpga",
"storage",
"ip"
],
"type": "string"
},
"lane": {
"description": "lane (actions: tee)",
"enum": [
"hardware",
"simulator"
],
"type": "string"
},
"me": {
"description": "your libp2p peer id (base58) — returns your shard, config and command (actions: shards)",
"type": "string"
},
"model": {
"description": "the model the node must serve (e.g. hypernova-60b, littlelamb) (actions: ai, gpu, join)",
"type": "string"
},
"name": {
"description": "2 to 64 characters (actions: builders)",
"type": "string"
},
"node": {
"description": "did:taifoon:z… of one node (actions: economics)",
"type": "string"
},
"nonce": {
"description": "nonce (actions: builders)",
"type": "string"
},
"note": {
"description": "optional, ≤200 chars, stored with the intent (actions: hire)",
"type": "string"
},
"owner": {
"description": "0x wallet address that earns the GRID points (actions: join, economics, node, bench)",
"type": "string"
},
"payout": {
"description": "Optional: grid (default, the full rate) or cash (USDC at the TSUL rate, 70 %) (actions: node)",
"enum": [
"grid",
"cash"
],
"type": "string"
},
"pool": {
"description": "Leave it out: the pool is Taifoon's side and is derived on the server (the Taifoon founding pool, fee 0). Kept only for nodes from before 2026-10-11 that still send one; honoured on first registration only. (actions: join)",
"type": "string"
},
"prompt": {
"description": "your prompt (one user message) (actions: ai)",
"type": "string"
},
"provider": {
"description": "optional: a specific measured endpoint from the providers list (actions: ai)",
"type": "string"
},
"ref": {
"description": "Optional: the 0x wallet that referred this resource. It earns a share of what the resource accrues (measured work only). Never the owner itself. (actions: join, node)",
"type": "string"
},
"reference": {
"description": "kind=gpu: the market class your price is checked against (default llama-3.1-8b) (actions: join)",
"enum": [
"llama-3.1-8b",
"llama-3.3-70b",
"qwen-2.5-72b",
"deepseek-v3"
],
"type": "string"
},
"replication": {
"description": "collectors per shard (default 2) (actions: shards)",
"maximum": 8,
"minimum": 1,
"type": "integer"
},
"resource": {
"description": "only avenues for this resource (actions: avenues)",
"enum": [
"gpu",
"rpc",
"storage",
"agent",
"compute"
],
"type": "string"
},
"rules": {
"description": "rules (actions: tee)",
"maxLength": 8000,
"type": "string"
},
"sell": {
"description": "kind=gpu: true lists the node for sale at the BROKER's market price for its reference class (the rig never names a price; the cheapest other venue, input and output apart, sets it); the node is checked (battery + fingerprint) and owned by your key (actions: join)",
"type": "boolean"
},
"signature": {
"description": "step 2: the personal_sign of the message step 1 returned (actions: builders)",
"type": "string"
},
"state": {
"description": "state (actions: prices)",
"enum": [
"LIVE",
"QUOTE_ONLY",
"RANKED",
"BILLED_USD",
"DENOMINATED",
"PROPOSED",
"BUILD",
"DESIGN"
],
"type": "string"
},
"units": {
"description": "how many resources (default 1) (actions: hire)",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"vram_gb": {
"description": "VRAM of one card in GB (0 or omitted = no GPU) (actions: bench)",
"minimum": 0,
"type": "number"
},
"wallet": {
"description": "0x wallet that joins (and later earns GRID and mints the pass) (actions: builders, settlement)",
"type": "string"
}
},
"type": "object"
},
"name": "taifoon_grid",
"outputSchema": null
},
{
"description": "Hires a chosen agent end to end: terms, offer, delivery over its own protocol, assurance and coverage pools, settlement plan, lifecycle. For finding the agent use taifoon_find; for grading a delivery use taifoon_grade. Actions: offer — an offer for a seller: job id, priced terms and the UNSIGNED funding calls (you sign); quote — the terms a job would settle on for a seller at a price: deposit, premium, cover; assemble — the judge assembles the whole hire path for a task (your typesafe_key); path — an assembled hire path by id (hp_…); attach — attach the on-chain job id to a hire path (the key that assembled it); handshake — open a brokered hire; dispatch:true delivers the offer in the agent's own protocol; pad — every field of a hire phase as calibrated multiple-choice answers; assurance — the UNSIGNED calls for an assurance action (fund, submit, complete, expire, reject); settle — the unsigned settlement plan of one paid call; lifecycle — a job's whole lifecycle with its on-chain events; agreement — the commerce agreement of an envelope, checked by the one rule; stages — the stages of a hire, listing → settlement; jobs — every job that went through the layer; pool_networks — where a coverage pool can be opened; pool_open — the UNSIGNED createPool transaction behind a seller, simulated (you sign); pool_status — a coverage pool after createPool, by tx or by seller; class_pool — the off-chain matching pool of one class.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"default": "offer",
"description": "what to do (default offer): offer | quote | assemble | path | attach | handshake | pad | assurance | settle | lifecycle | agreement | stages | jobs | pool_networks | pool_open | pool_status | class_pool",
"enum": [
"offer",
"quote",
"assemble",
"path",
"attach",
"handshake",
"pad",
"assurance",
"settle",
"lifecycle",
"agreement",
"stages",
"jobs",
"pool_networks",
"pool_open",
"pool_status",
"class_pool"
],
"examples": [
"offer"
],
"type": "string"
},
"address": {
"description": "the agent’s owner / seller address (full 20 bytes) (actions: handshake)",
"type": "string"
},
"agent_id": {
"description": "agent id (actions: handshake)",
"type": "string"
},
"agreement": {
"description": "an agreement to check (a producer checking before it sends) (actions: agreement)",
"type": "object"
},
"api_key": {
"description": "api key (actions: offer, assemble, attach, handshake, pad)",
"type": "string"
},
"args": {
"description": "MCP: the tool arguments (actions: handshake)",
"type": "object"
},
"asset": {
"description": "pool asset, symbol or address; default the line’s job token (USDC; dUSDC on the devnet) (actions: pool_open, pool_status)",
"type": "string"
},
"bar": {
"description": "bar (actions: pad)",
"type": "number"
},
"body": {
"description": "body (actions: offer, settle)",
"type": "object"
},
"budget_usdc": {
"description": "budget usdc (actions: assemble, handshake)",
"type": "number"
},
"buyer": {
"description": "buyer (actions: jobs)",
"enum": [
"ours",
"outside",
"visitor",
"unknown"
],
"type": "string"
},
"chain": {
"description": "36927 (devnet), 8453 (Base) or none (off-chain broker hires) (actions: jobs)",
"type": "string"
},
"chain_id": {
"description": "chain id (actions: quote, attach, handshake, pad, assurance, lifecycle, pool_open, pool_status)",
"type": "integer"
},
"class": {
"description": "class (actions: quote, jobs, class_pool)",
"type": "string"
},
"dispatch": {
"description": "dispatch (actions: handshake)",
"type": "boolean"
},
"dry": {
"description": "dry (actions: pad)",
"type": "boolean"
},
"envelope_id": {
"description": "0x + 64 hex: an envelope the pipe holds (actions: agreement)",
"type": "string"
},
"from": {
"description": "the wallet that will sign (the simulation runs from it); default the seller (actions: pool_open)",
"type": "string"
},
"hirer": {
"description": "hirer (actions: handshake)",
"type": "string"
},
"id": {
"description": "id (actions: path, attach, jobs)",
"type": "string"
},
"job_id": {
"description": "job id (actions: attach, lifecycle)",
"type": "string"
},
"kind": {
"description": "kind (actions: handshake, jobs)",
"enum": [
"mcp",
"a2a",
"onchain",
"n8n"
],
"type": "string"
},
"limit": {
"description": "limit (actions: jobs)",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"line": {
"description": "the factory line; default v4 on Base and Arc, layer on the devnet (v4-glmr is a devnet line). The first line (layer) on Base and Arc answers 409 line_closed: its vaults do not expose encumbered() and freeAssets() (actions: pool_open, pool_status)",
"enum": [
"layer",
"v4",
"v4-glmr"
],
"type": "string"
},
"name": {
"description": "name (actions: pool_open)",
"type": "string"
},
"override": {
"description": "open behind a mainnet seller that does not meet the pool rule (actions: pool_open)",
"type": "boolean"
},
"page": {
"description": "page (actions: jobs)",
"minimum": 1,
"type": "integer"
},
"phase": {
"description": "phase (actions: pad)",
"enum": [
"quote",
"calls",
"batch",
"assemble"
],
"type": "string"
},
"price": {
"description": "smallest units of the settlement token (actions: quote, pad)",
"type": "string"
},
"price_usdc": {
"description": "price usdc (actions: quote)",
"type": "number"
},
"prove": {
"description": "prove (actions: lifecycle)",
"type": "boolean"
},
"required_skills": {
"description": "required skills (actions: assemble, handshake)",
"items": {
"type": "string"
},
"type": "array"
},
"seller": {
"description": "seller (actions: quote, pad, jobs, pool_open, pool_status)",
"type": "string"
},
"skills": {
"description": "skills (actions: pad)",
"items": {
"type": "string"
},
"type": "array"
},
"stage": {
"description": "one stage id, or omit for all (actions: stages)",
"type": "string"
},
"symbol": {
"description": "symbol (actions: pool_open)",
"type": "string"
},
"task": {
"description": "task (actions: assemble, handshake, pad)",
"type": "string"
},
"tenant": {
"description": "tenant (actions: quote, lifecycle)",
"enum": [
"moonbeam"
],
"type": "string"
},
"tool": {
"description": "MCP: the tool to call (actions: handshake)",
"type": "string"
},
"tx_hash": {
"description": "the createPool transaction (then seller is not needed) (actions: pool_status)",
"type": "string"
},
"typesafe_key": {
"description": "typesafe key (actions: assemble, pad)",
"type": "string"
},
"view": {
"description": "counts: the totals and the sellers that served through us, no rows (actions: jobs)",
"enum": [
"counts"
],
"type": "string"
}
},
"type": "object"
},
"name": "taifoon_hire",
"outputSchema": null
},
{
"description": "Reads the live network, the stream and protocol order state: sellers online, RPC health, stuck orders, projects, Lambda Studio, Twigster. For your own account use taifoon_account. Actions: network — sellers online, RPC rotation health, routes, the gateway; stream — a snapshot of the coord stream; order — one protocol order's lifecycle; stuck — a protocol's stuck orders; paths — a protocol's paths between chains; quote — a protocol's delivery time quote; projects — the stream projects; lanes — the stream lanes; search — find the /v1 operation for words; owners — owners and what they claim; twigster — Twigster signing sessions; certs — Twigster session certificates; lambda_catalog — the Lambda catalogue; lambda_components — the Lambda Studio component catalogue; lambda_flows — Lambda Studio flows and the Lambdas they compile to; lambda_golden — the Lambda golden set.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"default": "network",
"description": "what to do (default network): network | stream | order | stuck | paths | quote | projects | lanes | search | owners | twigster | certs | lambda_catalog | lambda_components | lambda_flows | lambda_golden",
"enum": [
"network",
"stream",
"order",
"stuck",
"paths",
"quote",
"projects",
"lanes",
"search",
"owners",
"twigster",
"certs",
"lambda_catalog",
"lambda_components",
"lambda_flows",
"lambda_golden"
],
"examples": [
"network"
],
"type": "string"
},
"api_key": {
"description": "your tfr_ key (optional for keyless reads) (actions: stream, order, stuck, paths, quote, projects, lanes, search, owners, twigster, certs, lambda_catalog, lambda_components, lambda_flows, lambda_golden)",
"type": "string"
},
"chain": {
"description": "components serving one caip-2 chain (actions: lambda_components, lambda_golden)",
"type": "string"
},
"dst": {
"description": "destination chain id (actions: stuck, paths, quote)",
"type": "string"
},
"key": {
"description": "path parameter :key (actions: order)",
"type": "string"
},
"kind": {
"description": "components of one kind (quote, route, settle, release, venue, market-making, agent-tool, payment, read, stream, abi) (actions: lambda_components)",
"type": "string"
},
"limit": {
"description": "at most 500 (actions: stuck, search)",
"type": "string"
},
"native": {
"description": "1: native only; 0: borrowed only (actions: lambda_components)",
"type": "string"
},
"protocol": {
"description": "path parameter :protocol (actions: order, stuck, paths, quote)",
"type": "string"
},
"q": {
"description": "words or a phrase (actions: search)",
"type": "string"
},
"reason": {
"description": "one of the protocol’s reasons (see reasons[]) (actions: stuck)",
"type": "string"
},
"ref": {
"description": "path parameter :ref (actions: certs)",
"type": "string"
},
"src": {
"description": "source chain id (actions: stuck, paths, quote)",
"type": "string"
}
},
"type": "object"
},
"name": "taifoon_observe",
"outputSchema": null
},
{
"description": "Call any public operation of the coordination API by its /v1 name (GET /v1/ops/search finds the one you need; GET /v1/openapi.json lists them all). Path parameters are filled from params by name (:protocol → params.protocol); the rest become the query string, or the JSON body for a POST. Pass api_key for keyed operations.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"api_key": {
"description": "your tfr_ key, for keyed operations (keyless reads need none)",
"type": "string"
},
"body": {
"description": "the JSON body of a POST",
"type": "object"
},
"method": {
"description": "default GET",
"enum": [
"GET",
"POST"
],
"type": "string"
},
"op": {
"description": "the operation name, e.g. protocol/:protocol/stuck",
"type": "string"
},
"params": {
"description": "path and query parameters by name",
"type": "object"
}
},
"required": [
"op"
],
"type": "object"
},
"name": "taifoon_op",
"outputSchema": null
},
{
"description": "Uses the Taifoon orderbook (spot ETH-USDG on Robinhood Chain): account, deposit route, orders, withdrawals, settlement records. For tenant vaults use taifoon_vault. Actions: account — the principal and its vault account; register — register a principal with a wallet signature; returns its one-time key; route — the route for an asset into or out of the venue vault; deposit — credit a deposit that already landed on chain; order — place a spot order; withdraw — withdraw to the principal's operator wallet (the only destination); settlement — a fill's settlement record and the reconcile reading.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"account": {
"description": "the operator wallet the transfer came from (actions: deposit)",
"type": "string"
},
"action": {
"default": "account",
"description": "what to do (default account): account | register | route | deposit | order | withdraw | settlement",
"enum": [
"account",
"register",
"route",
"deposit",
"order",
"withdraw",
"settlement"
],
"examples": [
"account"
],
"type": "string"
},
"amount": {
"description": "amount (actions: route)",
"type": "number"
},
"api_key": {
"description": "api key (actions: account, deposit, order, withdraw)",
"type": "string"
},
"asset": {
"description": "USDG | ETH | WETH | tICP | TRN (actions: route, deposit, withdraw)",
"type": "string"
},
"direction": {
"description": "direction (actions: route)",
"enum": [
"in",
"out"
],
"type": "string"
},
"fill_id": {
"description": "fill id (actions: settlement)",
"type": "string"
},
"from": {
"description": "origin chain id (4663 Robinhood Chain, 8453 Base, 42161 Arbitrum One, 1 Ethereum, 5042 Arc) (actions: route)",
"type": "integer"
},
"market": {
"description": "ETH-USDG (actions: order)",
"type": "string"
},
"name": {
"description": "principal name: [a-z0-9_-], 1..64 (actions: register)",
"type": "string"
},
"operator": {
"description": "the wallet (0x…) that signs; deposits come from it, withdrawals go to it (actions: register)",
"type": "string"
},
"price": {
"description": "price (actions: order)",
"type": "string"
},
"qty": {
"description": "qty (actions: order)",
"type": "string"
},
"side": {
"description": "side (actions: order)",
"enum": [
"buy",
"sell"
],
"type": "string"
},
"signature": {
"description": "EIP-191 signature over the message; omit to get the exact message to sign (actions: register)",
"type": "string"
},
"signed_at": {
"description": "unix seconds in the message (10-minute window) (actions: register)",
"type": "integer"
},
"tif": {
"description": "tif (actions: order)",
"enum": [
"gtc",
"ioc"
],
"type": "string"
},
"to": {
"description": "the operator wallet (actions: withdraw)",
"type": "string"
},
"tx_hash": {
"description": "the transfer transaction (0x… 32 bytes) (actions: deposit)",
"type": "string"
},
"units": {
"description": "whole units as a decimal string, e.g. \"1.25\" (actions: deposit, withdraw)",
"type": "string"
}
},
"type": "object"
},
"name": "taifoon_orderbook",
"outputSchema": null
},
{
"description": "Proves blocks, transactions, logs and transfers under the Taifoon superroot. For reading chain data without a proof use taifoon_chain. Actions: tx — one transaction inside the superroot (chain, tx); item — anything the superroot commits, by kind: tx, log, receipt, state; block — a block under the superroot (proof.verify.v5); superroot — the current superroot and the chains it includes; transfer — attest a cross-chain CCTP transfer; finality — what a V5 finality type id means.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"default": "tx",
"description": "what to do (default tx): tx | item | block | superroot | transfer | finality",
"enum": [
"tx",
"item",
"block",
"superroot",
"transfer",
"finality"
],
"examples": [
"tx"
],
"type": "string"
},
"api_key": {
"description": "api key (actions: item)",
"type": "string"
},
"block_number": {
"description": "Block number on that chain (actions: block)",
"type": "integer"
},
"blocks": {
"description": "blocks (actions: item)",
"items": {
"minimum": 0,
"type": "integer"
},
"maxItems": 256,
"type": "array"
},
"chain_id": {
"description": "any chain the layer reads (GET /v1/rpc): 8453, 5042, 1, 56, 43114, 42161, 137, 10, 4663, 42220, 36927, 3692781, 999, 99901, 2741, 196, 143, 100; another chain answers 404 chain_not_read (actions: tx, item, block, transfer)",
"type": "integer"
},
"key": {
"description": "key (actions: item)",
"type": "string"
},
"kind": {
"description": "kind (actions: item)",
"enum": [
"tx",
"log",
"order",
"transition",
"blocks",
"protocols"
],
"type": "string"
},
"log_index": {
"description": "log index (actions: item)",
"minimum": 0,
"type": "integer"
},
"protocol": {
"description": "protocol (actions: item)",
"type": "string"
},
"seqs": {
"description": "seqs (actions: item)",
"items": {
"minimum": 0,
"type": "integer"
},
"maxItems": 256,
"type": "array"
},
"tx_hash": {
"description": "tx hash (actions: tx, item, transfer)",
"type": "string"
},
"type_id": {
"description": "type id (actions: finality)",
"maximum": 15,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "taifoon_prove",
"outputSchema": null
},
{
"description": "Creates a tenant with a free key (tfr_free_…, shown once), or a free RPC key with its gateway URL and allowance. For reading an existing account use taifoon_account. Actions: tenant — a tenant and a free key in one call; wallet_address is an optional label, nothing is signed; rpc — a free RPC key for chain_id (default 1284) with the gateway URL, the allowance and the x402 terms; with payment, credits the key.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"default": "tenant",
"description": "what to do (default tenant): tenant | rpc",
"enum": [
"tenant",
"rpc"
],
"examples": [
"tenant"
],
"type": "string"
},
"agent_id": {
"description": "optional ERC-8004 id \"<chain>:<id>\" (a label on your tenant) (actions: tenant)",
"type": "string"
},
"api_key": {
"description": "api key (actions: rpc)",
"type": "string"
},
"chain_id": {
"description": "the chain you want to read (default 1284 Moonbeam); the answer names its gateway URL (actions: rpc)",
"type": "integer"
},
"pay_chain_id": {
"description": "the pay chain of the transfer quote; absent = Base (actions: rpc)",
"enum": [
8453,
42161,
5042,
143,
4663
],
"type": "integer"
},
"payment": {
"description": "the x402 PAYMENT-SIGNATURE header value (base64) for the accepts a previous call returned (actions: rpc)",
"type": "string"
},
"plan": {
"description": "a 30-day plan instead of a balance: builder 99 USDC (110 of use), team 199 (240), protocol 299 (380); paid and credited the same way (actions: rpc)",
"enum": [
"builder",
"team",
"protocol"
],
"type": "string"
},
"tx": {
"description": "a settled subscribe payment whose credit was not written (actions: rpc)",
"type": "string"
},
"usdc": {
"description": "usdc (actions: rpc)",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"wallet_address": {
"description": "optional: a 0x wallet address to label your tenant with (nothing is signed; leave it out) (actions: tenant)",
"type": "string"
}
},
"type": "object"
},
"name": "taifoon_register",
"outputSchema": null
},
{
"description": "Lists you as a seller: register your agent by its card, enrich it, read the offers sent to you, register a protocol for decoding. For buying use taifoon_find. Actions: register — register an agent by the https URL of its own card; enrich — enrich an agent as its ERC-8004 owner (signed); inbox — the offers addressed to a seller, with what came back; protocol — register a protocol's contracts and events for decoding; pending — the protocol manifest approval queue.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"abi": {
"description": "abi (actions: protocol)",
"items": {
"type": "object"
},
"type": "array"
},
"action": {
"default": "register",
"description": "what to do (default register): register | enrich | inbox | protocol | pending",
"enum": [
"register",
"enrich",
"inbox",
"protocol",
"pending"
],
"examples": [
"register"
],
"type": "string"
},
"actions": {
"description": "actions (actions: protocol)",
"items": {
"properties": {
"call": {
"properties": {
"args_from": {
"items": {
"type": "string"
},
"type": "array"
},
"fn": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"to",
"fn",
"args_from"
],
"type": "object"
},
"chain": {
"type": "string"
},
"name": {
"type": "string"
},
"when": {
"type": "string"
}
},
"required": [
"name",
"when",
"chain",
"call"
],
"type": "object"
},
"type": "array"
},
"agent_id": {
"description": "agent id (actions: register, enrich)",
"type": "string"
},
"author": {
"description": "author (actions: protocol)",
"type": "string"
},
"card_url": {
"description": "card url (actions: register)",
"type": "string"
},
"chain_id": {
"description": "chain id (actions: register, enrich)",
"type": "integer"
},
"contracts": {
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"description": "chain id to list of 0x addresses (actions: protocol)",
"type": "object"
},
"data": {
"description": "{ card_url?, endpoints?: [{ url, kind: mcp|a2a|a2a-legacy|x402|webhook }], skills?: [tags], classes?: [class ids], name?, description? } (actions: enrich)",
"type": "object"
},
"docs": {
"description": "docs (actions: protocol)",
"type": "string"
},
"dry_run": {
"description": "dry run (actions: protocol)",
"type": "boolean"
},
"events": {
"description": "events (actions: protocol)",
"items": {
"properties": {
"anonymous": {
"type": "boolean"
},
"indexed": {
"type": "integer"
},
"name": {
"type": "string"
},
"role": {
"enum": [
"deposit",
"fill",
"other"
],
"type": "string"
},
"signature": {
"type": "string"
},
"topic0": {
"type": "string"
}
},
"required": [
"signature",
"topic0",
"role"
],
"type": "object"
},
"type": "array"
},
"expires": {
"description": "expires (actions: enrich)",
"type": "integer"
},
"fee_bps": {
"description": "fee bps (actions: protocol)",
"type": "integer"
},
"fill_selector": {
"description": "fill selector (actions: protocol)",
"type": [
"string",
"null"
]
},
"fill_topic": {
"description": "fill topic (actions: protocol)",
"type": [
"string",
"null"
]
},
"finality": {
"description": "finality (actions: protocol)",
"type": "string"
},
"grade": {
"description": "also grade the manifest: code verified the facts, Jev answers the rubric over them; spends one of your grades (actions: protocol)",
"type": "boolean"
},
"hirer": {
"description": "hirer (actions: inbox)",
"type": "string"
},
"id": {
"description": "id (actions: protocol)",
"type": "string"
},
"identity": {
"description": "identity (actions: protocol)",
"enum": [
"mechanism",
"deployment"
],
"type": "string"
},
"key": {
"description": "key (actions: protocol)",
"type": "string"
},
"limit": {
"description": "limit (actions: inbox)",
"type": "integer"
},
"name": {
"description": "name (actions: protocol)",
"type": "string"
},
"nonce": {
"description": "nonce (actions: enrich)",
"type": "string"
},
"provider": {
"description": "provider (actions: inbox)",
"type": "string"
},
"signature": {
"description": "signature (actions: enrich, protocol)",
"type": "string"
},
"sla_ms": {
"description": "sla ms (actions: protocol)",
"type": "integer"
},
"source_topic": {
"description": "source topic (actions: protocol)",
"type": "string"
},
"state": {
"description": "state (actions: inbox)",
"type": "string"
},
"states": {
"description": "states (actions: protocol)",
"items": {
"type": "string"
},
"type": "array"
},
"status": {
"description": "status (actions: pending)",
"enum": [
"submitted",
"approved",
"rejected",
"deprecated"
],
"type": "string"
},
"supported_dst": {
"description": "supported dst (actions: protocol)",
"items": {
"type": "integer"
},
"type": "array"
},
"transitions": {
"description": "transitions (actions: protocol)",
"items": {
"properties": {
"bind": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"from": {
"type": [
"string",
"null"
]
},
"guards": {
"items": {
"type": "string"
},
"type": "array"
},
"join": {
"type": "string"
},
"name": {
"type": "string"
},
"proof": {
"enum": [
"receipt",
"none"
],
"type": "string"
},
"to": {
"type": "string"
},
"trigger": {
"properties": {
"contracts": {
"enum": [
"registered",
"any"
],
"type": "string"
},
"event": {
"type": "string"
},
"side": {
"enum": [
"source",
"fill",
"refund",
"other"
],
"type": "string"
}
},
"required": [
"event",
"side"
],
"type": "object"
}
},
"required": [
"name",
"from",
"to",
"trigger",
"bind",
"proof"
],
"type": "object"
},
"type": "array"
},
"type": {
"description": "type (actions: protocol)",
"enum": [
"bridge",
"intent",
"aggregator",
"dex",
"amm"
],
"type": "string"
},
"version": {
"description": "version (actions: protocol)",
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "taifoon_sell",
"outputSchema": null
},
{
"description": "Reads a tenant vault and builds the owner-signed acts that control it. Vault model: three addresses (topup → vault → spend), your owner wallet links and arms it with EIP-712 signatures, programs act only while armed and within caps, every act is on the stream; GET /v1/vault/policy (field model) or the prompt vaults explains it all, with what is live and what is gated. For the legacy key balance use taifoon_account. Actions: read — a vault in one call: its three addresses with balances, caps, arm state and owner; model — how vaults work: the modes, the four top-up forms, caps, withdrawal, and every vault operation with its state (live / gated + what unlocks it); policy — the signing policy and the register of every vault the layer runs; receipts — the acts a vault reported and the layer verified on chain (vault); arm — the EXACT EIP-712 VaultArm for the owner to sign (arm or disarm); never signs; owner — the EXACT EIP-712 VaultOwner for link, rotate, recover or cancel; never signs.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"action": {
"default": "read",
"description": "what to do (default read): read | model | policy | receipts | arm | owner",
"enum": [
"read",
"model",
"policy",
"receipts",
"arm",
"owner"
],
"examples": [
"read"
],
"type": "string"
},
"api_key": {
"description": "your tfr_ key (actions: policy, receipts)",
"type": "string"
},
"armed": {
"description": "true arms (default), false disarms (always honoured, no expiry rule) (actions: arm)",
"type": "boolean"
},
"days": {
"description": "how long the arm lasts (default 7, at most 30) (actions: arm)",
"maximum": 30,
"minimum": 1,
"type": "integer"
},
"owner": {
"description": "the 0x wallet the act installs (link, rotate, recover); omitted for cancel (the current owner) (actions: owner)",
"type": "string"
},
"params": {
"description": "operation parameters, e.g. { \"vault\": \"vault:tenant:tenant-3\" } (actions: policy, receipts)",
"type": "object"
},
"vault": {
"description": "the tenant vault id, vault:tenant:<tenant> (e.g. vault:tenant:tenant-3) (actions: read, arm, owner)",
"type": "string"
}
},
"type": "object"
},
"name": "taifoon_vault",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:6b54daf71b4ea0d84039d0869ea45c7a965c6b54c97e75f0dcc711133c0522db | sha256sum