English Français العربية

Blackwood State

Official registry AI and agents

Pay-per-call tools for agents: onchain data, ECB FX rates, text tools. USDC on Base, x402

Website

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http blackwood-state 'https://x402-gateway.blackwoodstate8.workers.dev/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "blackwood-state": {
            "type": "http",
            "url": "https://x402-gateway.blackwoodstate8.workers.dev/mcp"
        }
    }
}
NPM package @blackwood-state/mcp
Claude Code 
claude mcp add blackwood-state -e 'BLACKWOOD_PRIVATE_KEY=<your blackwood_private_key>' -e 'BLACKWOOD_CREDITS_KEY=<your blackwood_credits_key>' -e 'BLACKWOOD_MAX_USD_PER_CALL=0.05' -e 'BLACKWOOD_MAX_USD_PER_DAY=1' -- npx -y @blackwood-state/mcp@0.2.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "blackwood-state": {
            "command": "npx",
            "args": [
                "-y",
                "@blackwood-state/mcp@0.2.0"
            ],
            "env": {
                "BLACKWOOD_PRIVATE_KEY": "<your blackwood_private_key>",
                "BLACKWOOD_CREDITS_KEY": "<your blackwood_credits_key>",
                "BLACKWOOD_MAX_USD_PER_CALL": "0.05",
                "BLACKWOOD_MAX_USD_PER_DAY": "1"
            }
        }
    }
}

Environment variables

  • BLACKWOOD_PRIVATE_KEY secret Optional. Key of a wallet that pays over x402 after the free starting credit runs out
  • BLACKWOOD_CREDITS_KEY secret Optional. Prepaid credit key (bwk_...)
  • BLACKWOOD_MAX_USD_PER_CALL Spend cap per call in USD
  • BLACKWOOD_MAX_USD_PER_DAY Spend cap per UTC day for x402 payments in USD

Frequently asked questions

What is Blackwood State?

Pay-per-call tools for agents: onchain data, ECB FX rates, text tools. USDC on Base, x402

How do I install Blackwood State?

It runs as a remote server. In Claude Code: claude mcp add --transport http blackwood-state 'https://x402-gateway.blackwoodstate8.workers.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Blackwood State need an API key?

Yes. It expects BLACKWOOD_PRIVATE_KEY, BLACKWOOD_CREDITS_KEY, which you set in its configuration.

Who maintains Blackwood State?

It is published by Blackwood-State. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.