Blackwood State

Name: Blackwood State
Author: Blackwood-State

Blackwood-State

Get started Website & docs

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

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

Local

claude mcp add blackwood-state --env BLACKWOOD_PRIVATE_KEY='<BLACKWOOD_PRIVATE_KEY>' --env BLACKWOOD_CREDITS_KEY='<BLACKWOOD_CREDITS_KEY>' -- npx -y @blackwood-state/mcp

~/.codex/config.toml

[mcp_servers.blackwood-state]
command = "npx"
args = ["-y", "@blackwood-state/mcp"]
env = { BLACKWOOD_PRIVATE_KEY = "<BLACKWOOD_PRIVATE_KEY>", BLACKWOOD_CREDITS_KEY = "<BLACKWOOD_CREDITS_KEY>" }

# codex mcp add blackwood-state --env BLACKWOOD_PRIVATE_KEY='<BLACKWOOD_PRIVATE_KEY>' --env BLACKWOOD_CREDITS_KEY='<BLACKWOOD_CREDITS_KEY>' -- npx -y @blackwood-state/mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "blackwood-state": {
      "command": "npx",
      "args": [
        "-y",
        "@blackwood-state/mcp"
      ],
      "env": {
        "BLACKWOOD_PRIVATE_KEY": "<BLACKWOOD_PRIVATE_KEY>",
        "BLACKWOOD_CREDITS_KEY": "<BLACKWOOD_CREDITS_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "blackwood-state": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@blackwood-state/mcp"
      ],
      "env": {
        "BLACKWOOD_PRIVATE_KEY": "<BLACKWOOD_PRIVATE_KEY>",
        "BLACKWOOD_CREDITS_KEY": "<BLACKWOOD_CREDITS_KEY>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "blackwood-state": {
      "command": "npx",
      "args": [
        "-y",
        "@blackwood-state/mcp"
      ],
      "env": {
        "BLACKWOOD_PRIVATE_KEY": "<BLACKWOOD_PRIVATE_KEY>",
        "BLACKWOOD_CREDITS_KEY": "<BLACKWOOD_CREDITS_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "blackwood-state": {
      "command": "npx",
      "args": [
        "-y",
        "@blackwood-state/mcp"
      ],
      "env": {
        "BLACKWOOD_PRIVATE_KEY": "<BLACKWOOD_PRIVATE_KEY>",
        "BLACKWOOD_CREDITS_KEY": "<BLACKWOOD_CREDITS_KEY>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "blackwood-state": {
      "command": "npx",
      "args": [
        "-y",
        "@blackwood-state/mcp"
      ],
      "env": {
        "BLACKWOOD_PRIVATE_KEY": "<BLACKWOOD_PRIVATE_KEY>",
        "BLACKWOOD_CREDITS_KEY": "<BLACKWOOD_CREDITS_KEY>"
      }
    }
  }
}

Remote

claude mcp add --transport http blackwood-state https://x402-gateway.blackwoodstate8.workers.dev/mcp

~/.codex/config.toml

[mcp_servers.blackwood-state]
url = "https://x402-gateway.blackwoodstate8.workers.dev/mcp"

# codex mcp add blackwood-state --url https://x402-gateway.blackwoodstate8.workers.dev/mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "blackwood-state": {
      "url": "https://x402-gateway.blackwoodstate8.workers.dev/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "blackwood-state": {
      "type": "http",
      "url": "https://x402-gateway.blackwoodstate8.workers.dev/mcp"
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "blackwood-state": {
      "httpUrl": "https://x402-gateway.blackwoodstate8.workers.dev/mcp"
    }
  }
}

claude_desktop_config.json · Customize › Connectors › Add custom connector

{
  "mcpServers": {
    "blackwood-state": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://x402-gateway.blackwoodstate8.workers.dev/mcp"
      ]
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "blackwood-state": {
      "url": "https://x402-gateway.blackwoodstate8.workers.dev/mcp"
    }
  }
}

Environment variables

BLACKWOOD_PRIVATE_KEY
BLACKWOOD_CREDITS_KEY

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Local

Remote

Environment variables

Related