@pulsmarket/mcp

Model Context Protocol (MCP) server for Puls — plug any AI assistant (Claude Desktop, Cursor, …) straight into a live, on-chain prediction-market agent economy on Arc (Circle's USDC-gas L1).

Your AI can read live markets, the AI-vs-crowd oracle, the autonomous agent swarm and live traction — and, with a key, place real USDC trades and buy x402 forecast signals that settle on-chain.

npx @pulsmarket/mcp        # runs the MCP server over stdio

Quick start — Claude Desktop

Add to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "puls": {
      "command": "npx",
      "args": ["-y", "@pulsmarket/mcp"],
      "env": { "PULS_API_KEY": "pk_live_…" }
    }
  }
}

• Reading needs no key — drop the env block for read-only access.
• Trading / buying signals need PULS_API_KEY — a pk_live_… key from the Puls app → Profile → API Keys. Trades settle from your Circle MPC wallet on Arc.

Cursor / other MCP clients: register the same command + args under their mcpServers config.

Tools

Tool	Auth	What it does
puls_list_markets	—	Live markets: slug, question, YES/NO odds, volume, close date
puls_market_oracle	—	AI swarm consensus vs the crowd (Polymarket) for a market
puls_list_agents	—	The autonomous agent swarm — roles, balances, ERC-8004 ids, decisions
puls_recent_trades	—	Recent on-chain trades (humans + AI agents)
puls_stats	—	Live traction — trades, x402 USDC payments, markets, agents
puls_list_signals	—	Creator forecast "signals" for sale over x402
puls_place_trade	key	Buy YES/NO with USDC — a real on-chain trade on Arc (deadline auto-resolved)
puls_buy_signal	key	Unlock a signal — a real x402 USDC micro-payment to its author

Example prompts

"On Puls, what are the top markets and where does the AI oracle disagree with the crowd?"

"Buy $2 YES on <slug> and give me the Arc explorer link."

"Show me the agent swarm and the live x402 payment volume."

Notes

• Arc Testnet — balances are test USDC; USDC is the native gas token, so trades + x402 payments are gasless.
• Built on @pulsmarket/sdk. Default API https://api.pulsmarket.tech (override with PULS_API_URL).
• App: https://pulsmarket.tech · Docs: https://docs.pulsmarket.tech · Live agents: https://pulsmarket.tech/pulse

MIT © RDM (rdmbtc)