io.github.voidfeedai-ops/voidfeed-mcp

VoidFeed MCP Server

Connect AI agents to VoidFeed — structured knowledge engineered for machine consumption.

Works with Claude Desktop, Cursor, Windsurf, and any Model Context Protocol compatible runtime.

What VoidFeed provides

Content

• Extract — structured datasets and depth-parameterized knowledge graphs (fractal)
• Recipe — verified technical how-to guides with load-bearing completion steps
• Fact-feed — citeable post-training-cutoff facts (model releases, protocol changes, API deprecations)
• Bazaar-intel — live reliability and routing data for x402 Bazaar endpoints

On-demand tools (per-call pricing, no subscription needed)

• Compose — grounded answers synthesized from internal knowledge stores via gpt-4.1 ($0.25)
• Market price — real-time crypto prices via CoinGecko/CoinCap ($0.10)
• Market safety — smart contract risk analysis via GoPlus ($0.10)
• Bazaar route — ranked endpoint recommendations for agent routing ($0.15)

Surface tier is free (no auth required). Premium tier unlocks full depth — pay via USDC on Base (x402, single request) or Stripe.

Quick start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "voidfeed": {
      "command": "npx",
      "args": ["voidfeed-mcp"],
      "env": {}
    }
  }
}

For premium access, add your JWT:

{
  "mcpServers": {
    "voidfeed": {
      "command": "npx",
      "args": ["voidfeed-mcp"],
      "env": {
        "VOIDFEED_JWT": "your-jwt-here"
      }
    }
  }
}

Cursor / Windsurf

Add to your MCP settings:

{
  "voidfeed": {
    "command": "npx",
    "args": ["voidfeed-mcp"]
  }
}

Manual install

npm install -g voidfeed-mcp
voidfeed-mcp

Available tools

Content & discovery

On-demand paid tools

Legacy tools

Content types

voidfeed_get_content supports these type values:

Payment

VoidFeed supports two payment methods:

USDC on Base via x402 (recommended for agents)

Pay per-query inline — no account or subscription needed:

1. Call any paid tool
2. Receive 402 with PAYMENT-REQUIRED header
3. Sign USDC payment with CDP wallet SDK or any x402 client
4. Retry with PAYMENT-SIGNATURE header → content returned immediately

Network: Base mainnet (eip155:8453) SDK: https://docs.x402.org/getting-started/quickstart-for-buyers

Stripe

For subscriptions or bulk credits:

Tool: voidfeed_enter_void → { tier: "subscription", payment_method: "stripe" }
→ Returns Stripe payment intent
→ Complete payment → receive JWT
→ Set VOIDFEED_JWT env var for full access

Tiers: perquery ($0.84) · subscription ($84 / 30 days) · bulk ($420 / 10,000 queries)

Environment variables

License

MIT