Machine Money

Pay-per-call API for AI agents. An agent pays a small USDC fee on Solana per call (x402 pattern), the server verifies the payment on-chain, then returns the data. Own implementation — no code copied from Syra.

Run

nvm use 20
npm install
cp .env.example .env   # fill in TREASURY_ADDRESS
npm run build
npm start

Devnet by default (no real money). Switch SOLANA_RPC_URL / USDC_MINT to mainnet values only when ready.

Related MCP server: hyre-mcp

Endpoints

• GET /health — { ok: true }

• GET /api/insights/market-pulse?token=bitcoin — price, 24h change, 24h volume, 14-day RSI. Requires a Solana USDC payment signature in the X-Signature header. Returns 402 without a valid payment.

• GET /api/insights/token-safety?token=<mint> — safety score + level, holder concentration, authorities. Requires a Solana USDC payment signature in the X-Signature header. Returns 402 without a valid payment.

• GET /api/insights/whale-pulse?token=<mint> — whale transfers in 24h, whale count, coverage. Requires a Solana USDC payment signature in the X-Signature header. Returns 402 without a valid payment.

• GET /api/insights/alpha-bundle?token=<mint> — BUY/WAIT/AVOID verdict from safety + whale + momentum. Requires a Solana USDC payment signature in the X-Signature header. Returns 402 without a valid payment.

MCP server

argoo-mcp — the same four tools over MCP (stdio), for agents and MCP clients. Free and local: it calls the handlers directly, with no payment gate. The paid path stays the HTTP API above (0.05 USDC per call).

Install from npm (public):

npx -y argoo-mcp   # stdio, waits on stdin (Ctrl+C to exit)

Claude Desktop (claude_desktop_config.json) with the npm package:

{
  "mcpServers": {
    "argoo": {
      "command": "npx",
      "args": ["-y", "argoo-mcp"],
      "env": { "SOLANA_RPC_URL": "https://devnet.helius-rpc.com/?api-key=YOUR_KEY" }
    }
  }
}

Or install from source (development):

git clone https://github.com/higalih/Argoo.git
cd Argoo
npm install
npm run build
node dist/mcp-server.js   # stdio, waits on stdin (Ctrl+C to exit)

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "argoo": {
      "command": "node",
      "args": ["/absolute/path/to/Argoo/dist/mcp-server.js"],
      "env": { "SOLANA_RPC_URL": "https://devnet.helius-rpc.com/?api-key=YOUR_KEY" }
    }
  }
}

SOLANA_RPC_URL is optional — without it the server uses the public devnet RPC (may throttle); a Helius devnet endpoint is the fast path. Claude Desktop does not run from the project root, so pass SOLANA_RPC_URL in env explicitly (as above); otherwise it falls back to the public RPC. MCP Inspector (run from the project root, so .env is found):

npx @modelcontextprotocol/inspector node dist/mcp-server.js

Note: install from npm above for normal use. Clone + build is the development path — the repo is public, so anyone can clone and build it.

Layout

• src/index.ts — HTTP server + routing + static frontend

• src/paygate.ts — 402 gate + replay protection (one signature = one call)

• src/solana.ts — on-chain USDC payment verification

• src/endpoints.ts — data endpoints (CoinGecko, cached 60s)

• src/tokenSafety.ts — safety score + level (Solana RPC, cached 60s)

• src/whalePulse.ts — whale transfers 24h (Solana RPC, cached 60s)

• src/alphaBundle.ts — BUY/WAIT/AVOID verdict from safety + whale + momentum (cached 60s)

• src/cache.ts — tiny TTL cache

• src/config.ts — env config

• src/mcp-server.ts — MCP wrapper (argoo-mcp, stdio, no payment)

• public/ — landing page (vanilla HTML/JS)