Model Context Protocol (MCP)

Agents discover OnFRA tools via MCP and invoke them over REST with x402 payments. You can run the OnFRA MCP server locally or point your client to our remote manifest.

Local stdio (Recommended)

Run it locally with Node. Your client spawns npx and talks to OnFRA over stdio. Works in any stdio client (Cursor, Claude Desktop, LM Studio, Continue, MCP Inspector). Requires Node.js.

Run npx -y @jeffishmael/onfra-skill to test it.
Open your MCP config (e.g., claude_desktop_config.json or Cursor Settings → MCP).
Merge the snippet below into mcpServers.
Restart the client.

{
  "mcpServers": {
    "onfra-skill": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@jeffishmael/onfra-skill"],
      "env": {
        "CELO_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Keep CELO_PRIVATE_KEY out of source control — it stays securely on your machine to sign x402 payments.

Remote hosted

Skip the install — point at the hosted endpoint

No Node, no keys. The hosted endpoint exposes all OnFRA tools for financial analysis, lender screening, and verified reports.

Endpoint

https://wallet-profile-orpin.vercel.app/api/mcp

Streamable HTTP clients

For clients that support remote MCP URLs directly (Cursor, Claude, etc.):

{
  "mcpServers": {
    "onfra-mcp": {
      "url": "https://wallet-profile-orpin.vercel.app/api/mcp"
    }
  }
}

Stdio-only clients (mcp-remote bridge)

If your client only supports stdio, use mcp-remote to bridge to the hosted endpoint:

{
  "mcpServers": {
    "onfra-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://wallet-profile-orpin.vercel.app/api/mcp"]
    }
  }
}

MCP tools

Tool	Route	Description
`analyze_wallet`	`POST /api/agent/analyze`	Full financial analysis
`get_wallet_signal`	`GET /api/wallet/{address}/signals/{signal}`	Cached signal read
`screen_wallet`	`POST /api/lender/screen`	Lender underwriting screen
`chat_query`	`POST /api/agent/chat`	Natural-language queries
`generate_report`	`POST /api/agent/report`	Verified REP passport
`generate_statement`	`POST /api/agent/statement`	Generate transaction statement PDF
`verify_report`	`GET /api/agent/verify/{id}`	Verify REP-{id}

A2AAgent-to-Agent →ReferenceJSON schemas →