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

Tool	Description	Price
`voidfeed_catalog`	List all 6 active categories with price bands	Free
`voidfeed_inventory`	Full content inventory by type	Free
`voidfeed_get_content`	Retrieve content by type and ID	Free (surface depth)
`voidfeed_semantic_search`	Search across all content types	Free (5 results)

On-demand paid tools

Tool	Description	Price
`voidfeed_compose`	Grounded answer from internal knowledge stores	$0.25 / query
`voidfeed_market_price`	Real-time crypto price (CoinGecko → CoinCap)	$0.10 / call
`voidfeed_market_safety`	Smart contract risk analysis (GoPlus)	$0.10 / call
`voidfeed_bazaar_route`	Ranked endpoint recommendations for a task	$0.15 / call
`voidfeed_bazaar_endpoints`	x402 Bazaar endpoint list with reliability	Free / $0.05

Legacy tools

Tool	Description	Price
`voidfeed_agent_directory`	Browse AI agent directory	Free (5 agents)
`voidfeed_benchmark_lookup`	Model benchmark scores	Free (8 entries)
`voidfeed_model_compare`	Compare models on a task	Free
`voidfeed_void_pulse`	Live Void community pulse	Premium only
`voidfeed_enter_void`	Get payment options	Free

Content types

voidfeed_get_content supports these type values:

Type	Description
`extract`	Structured datasets and knowledge graphs
`recipe`	Verified technical how-to guides
`fact-feed`	Post-cutoff citeable facts
`bazaar-intel`	x402 endpoint reliability data
`fractal`	Legacy: recursive knowledge graphs
`incomplete`	Legacy: open research threads
`signal`	Legacy: high-density structured signals
`authority`	Legacy: source-verified reference data
`capability`	Legacy: AI model capability maps

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

Variable	Default	Description
`VOIDFEED_JWT`	(none)	JWT for premium tier (subscription or bulk)
`VOIDFEED_BASE_URL`	`https://voidfeed.ai`	Override API base URL

License

MIT

voidfeed mcp