Skip to content
MCP server

Blackwood State

Pay-per-call agent tools for web, SEC, PDF, domain and weather data, paid in USDC via x402

Install
Pricing
Paid
Platforms
API, CLI
Runs
Locally or Remotely
Version
1.2.0
Listing updated
1 day ago

About Blackwood State

Blackwood State is a paid MCP server for web search and scraping. It can run locally on your machine or as a hosted remote server.

Blackwood State sells small data calls that an agent pays for per request, in USDC on Base using the x402 payment protocol. The registry lists on-chain data, ECB foreign exchange rates and text tools, and the gateway's catalogue adds services such as web page to Markdown at 0.01 USDC, SEC company financials from 10-K filings by ticker at 0.02, PDF text extraction at 0.0025 per page up to 0.05 per call, and domain intelligence with WHOIS, DNS and certificate data at 0.02. A weather forecast service is also listed.

Each service description says what not to use it for: the web tool does not render JavaScript or get past logins or paywalls, the SEC tool is annual and US-only for the last two years, and the PDF tool has no OCR and skips files over 15 MB.

The npm server starts with a free credit, after which you can fund a wallet key or a prepaid credit key. Spending caps default to $0.05 per call and $1 per UTC day. There is a stdio package and a hosted HTTP endpoint.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://x402-gateway.blackwoodstate8.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "blackwood-state": {
      "url": "https://x402-gateway.blackwoodstate8.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • BLACKWOOD_PRIVATE_KEYOptional. Key of a wallet that pays over x402 after the free starting credit runs out
  • BLACKWOOD_CREDITS_KEYOptional. Prepaid credit key (bwk_...)
  • BLACKWOOD_MAX_USD_PER_CALLSpend cap per call in USD
  • BLACKWOOD_MAX_USD_PER_DAYSpend cap per UTC day for x402 payments in USD

What it does

x402 payments
Agents pay per call in USDC on Base with no account.
Spend caps
Defaults of $0.05 per call and $1 per day, adjustable.
Web to Markdown
Turns a public page into clean Markdown with links and metadata.
SEC financials
Annual revenue, income, EPS and balance sheet from 10-K filings.
PDF and domain tools
Extract PDF text and look up WHOIS, DNS and certificates.
Free starting credit
Try tools before wallet funding is needed.

Good for

  • Convert a public article to Markdown for an LLM
  • Pull two years of financials for a US ticker
  • Extract text from a PDF report
  • Run a quick domain lookup during due diligence

Pricing

Paid

Pay per call in USDC (e.g. 0.01 to 0.05 per call); free starting credit.

Prices change. Check x402-gateway.blackwoodstate8.workers.dev before you buy.

Blackwood State FAQ

How is it priced?

Per call in USDC, for example 0.01 for web to Markdown and 0.02 for SEC facts.

Is there a free trial?

The registry mentions a free starting credit before payment is needed.

Can spending run away?

Default caps are $0.05 per call and $1 per UTC day.

What can the web tool not do?

It does not handle JavaScript-rendered pages, logins, paywalls or PDFs.

Is Blackwood State free?

No. Blackwood State is a paid product.

How do I add Blackwood State to Claude Code?

Run this command in your terminal: claude mcp add --transport http blackwood-state https://x402-gateway.blackwoodstate8.workers.dev/mcp

What are the best alternatives to Blackwood State?

The closest alternatives to Blackwood State are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, Solana MCP by Vybe and Tapetide - Indian Stock Market MCP.

Alternatives to Blackwood State

  1. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping
  4. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  5. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments