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