TAIFOONPOST https://www.taifoon.io/api/mcp and the n8n community node n8n-nodes-taifoon-grid call the same public /api/grid/* routes and return the same bodies. No key, no account, no address. A quote is a quote, a hire is a record, and every body says settlement: NOT_DEPLOYED until the gates on the settlement design are real.One API, two doors
Pick the door your agent already speaks. Nothing is reachable through one that the other hides; where a door has no verb for a call, the row says so and the HTTP route is the fallback.
| What | MCP tool | n8n operation | HTTP |
|---|---|---|---|
| What the Grid accepts and pays, per kind | taifoon_grid_status | Status | GET /api/grid/join |
| Where the network is short + the bonus | taifoon_grid_pool | Pool | GET /api/grid/pool |
| What one resource earns per kind, live | taifoon_grid_economics | Economics | GET /api/grid/economics |
| Usable providers + a quote (no record) | taifoon_grid_hire | Quote | GET /api/grid/hire?kind&units&hours |
| The same, recorded under a hirer | taifoon_grid_hire + hirer | Hire | POST /api/grid/hire |
| Intents recorded so far | — (read the API) | Hires | GET /api/grid/hires |
| Bring an RPC endpoint or a GPU | taifoon_grid_join | — (HTTP node) | POST /api/grid/join |
| The one command that joins a box | taifoon_node_command | — | docker load + run taifoon/node |
MCP — the agent's door
JSON-RPC 2.0 over HTTP, tools-only, stateless. tools/list enumerates every tool; the seven Grid tools are listed above. A hire with a hirer argument records an intent and returns its id.
curl -s -X POST https://www.taifoon.io/api/mcp -H 'content-type: application/json' -d '{
"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"taifoon_grid_hire","arguments":{"kind":"storage","units":1,"hours":24,"hirer":"agent-7"}}
}'n8n — the workflow's door
Install the community node in your n8n instance and pick an operation. Quote and Hire add an outcome field — fulfilled, partial or short — so a workflow can branch honestly: when the Grid is short, the answer carries the bonus that filling it pays, and the right branch is to share a resource, not to wait.
# in your n8n nodes directory (~/.n8n/nodes) npm install https://grid.taifoon.dev/node/n8n-nodes-taifoon-grid-0.1.0.tgz # sha256 published beside it; npm publish waits on a token — the tarball is the real artefact today
A ready-to-import workflow that quotes, records, or branches to share is at /grid/n8n-hire.json. The node's source and its own tests live in the site repository under packages/n8n-nodes-taifoon-grid.
What either door can honestly promise
| Claim | True today? | Where it is enforced |
|---|---|---|
| Providers offered are usable now | yes | oracle pool: the last probe passed, not stale (≤ 15 min since it answered), not in backoff — read lastProbeTs per offer; both rules were exercised by negative controls on 2026-09-23 |
| The quote is derived, not guessed | yes | 10 GRID × live bonus × units × hours; 1 GRID = 0.001 USDC |
| A hire reserves capacity | no | a record only; nothing is charged, escrowed or pinned |
| A provider is paid for a hire | no | providers earn points for probes; USDC waits on the settlement gates |
| GPU / FPGA offers are proven | no | ranked only; a GPU becomes proven by NVIDIA attestation, which needs CC mode |