# Blackwood State

> Blackwood State is a paid MCP server for web search and scraping. Pay-per-call agent tools for web, SEC, PDF, domain and weather data, paid in USDC via x402. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI
- **Website:** https://x402-gateway.blackwoodstate8.workers.dev
- **MCP Registry name:** io.github.Blackwood-State/blackwood-state
- **Categories:** web search and scraping, finance and payments
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://x402-gateway.blackwoodstate8.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/blackwood-state
