MCP server

Connect an AI agent to NoFomo over the Model Context Protocol: read markets and clusters, and build transactions it signs itself.

Remote or local

Remote: POST /api/mcp

Your agent

Claude, or any MCP client

NoFomo MCP (stateless)

reads + transaction builders

Your wallet signs

the server never sees a key

Local: nofomo-mcp (stdio)

Your agent

spawns the package on your machine

nofomo-mcp

calls the same API, checks your spend limits

Robinhood Chain

the key never leaves your machine

FigureEither way, NoFomo never holds a key. Remote returns unsigned transactions; local signs on your machine, inside limits you set.

	Remote	Local
Endpoint	`POST /api/mcp`, Streamable HTTP, stateless	`nofomo-mcp` over stdio
Writes return	A `PreparedTx` for a wallet to sign	A sent transaction hash, signed locally
Keys	None	`NOFOMO_AGENT_KEY`, only on your machine
Best for	Research, monitoring, agents that hand transactions to a human or a wallet	Agents that act on their own, inside a spend limit

Connect

Terminal

claude mcp add --transport http nofomo https://nofomoagent.com/api/mcp

Terminal

claude mcp add nofomo \
  -e NOFOMO_AGENT_KEY=0xYOUR_AGENT_PRIVATE_KEY \
  -e NOFOMO_MAX_ETH_PER_TX=0.05 \
  -e NOFOMO_MAX_ETH_PER_DAY=0.2 \
  -- npx -y nofomo-mcp

claude_desktop_config.json

{
  "mcpServers": {
    "nofomo": {
      "command": "npx",
      "args": ["-y", "nofomo-mcp"],
      "env": {
        "NOFOMO_AGENT_KEY": "0xYOUR_AGENT_PRIVATE_KEY",
        "NOFOMO_MAX_ETH_PER_TX": "0.05",
        "NOFOMO_MAX_ETH_PER_DAY": "0.2"
      }
    }
  }
}

For the remote server instead, add a custom connector in Claude Desktop settings with the URL https://nofomoagent.com/api/mcp.

JSON-RPC over HTTP

curl -X POST https://nofomoagent.com/api/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Use a fresh wallet as the agent key, funded with only what the agent should be able to spend. Never paste a main wallet's key into a config file.

Tools

Amounts are decimal ETH strings like "0.01", ids look like current-3, and results use the same shapes as the API.

Read

find_markets
Search stock and Pons markets by symbol, name or address; filter by kind.
kind?, query?, sort?, limit?
get_market
One market: price, reserve, capacity per ceiling, open cluster.
market
list_clusters
Clusters, newest first, filtered by status, market or wallet.
status?, market?, wallet?, limit?
get_cluster
One cluster with its participants and, once cleared, its result.
id
get_execution
One mandate execution with its per-allocator fills.
id
get_stats
Network totals: clusters cleared and forming, capital, wallets, mandates.
no arguments

Transaction builders

On the remote server these return a PreparedTx: { chainId: 4663, to, data, value, description }. The description is written for the signer and always notes that the contracts are unaudited. Builders validate against live chain state, so a transaction that comes back is one the contract would accept at that moment.

submit_intent
Join the open cluster for a market, or open one if none is forming.
market, amountEth, windowSec?, ceilingBps?
join_cluster
Join a specific forming cluster.
clusterId, amountEth
cancel_intent
Leave a cluster before it closes, for a full refund.
clusterId
clear_cluster
Crank a closed cluster. Permissionless; costs only gas (send the suggested gas).
clusterId
claim
Claim tokens and any refund; retrieves parked stock tokens; forWallet pushes another's claim.
clusterId, wallet?, forWallet?
arm_mandate
Arm a mandate behind an originator with caps, ceiling, expiry and V2 scope.
originator, amountEth, perExecEth, dailyCapEth, ceilingBps, expiry?, market?, maxSpotEth?
revoke_mandate
Revoke a mandate and return its balance.
mandateId

Local signer and spend limits

The local package calls the same public API, then signs and sends with NOFOMO_AGENT_KEY. Before signing, it checks two limits you set:

Variable	Meaning
`NOFOMO_AGENT_KEY`	Private key of the agent wallet. Never sent anywhere.
`NOFOMO_MAX_ETH_PER_TX`	Largest ETH value the agent may send in one transaction.
`NOFOMO_MAX_ETH_PER_DAY`	Total ETH the agent may send per day.

These are local safety rails on top of the onchain ones (a cluster's ceiling, a mandate's caps). For an agent that spends someone else's capital, prefer a mandate: its limits are enforced by the contract, not by software on one machine.

A typical session

find_markets with tradable: true to see what can be cleared, and get_market for capacity at the ceiling you want.
submit_intent with a market and an amount. It joins the forming cluster, or opens one.
get_cluster to follow it. Change your mind before close with cancel_intent.
After close, clear_cluster if nobody has yet, then claim.

Documentation