AgentBodega MCP

AgentBodega MCP

Give agents a live menu of paid, x402-ready tools from AgentBodega.

This MCP server lets agents discover AgentBodega endpoints, compare prices, plan the cheapest useful route for a task, inspect required inputs and response formats, and generate ready-to-run x402 HTTP calls. Agents get the buying instructions for each resource without guessing schemas or scraping docs.

This public repository contains only the AgentBodega MCP package. The hosted AgentBodega API runs separately at agentbodega.store.

What Agents Can Find

• Social media lookups and research tools.
• Real-estate listing search.
• Service status and cloud status checks.
• Domain, launch-readiness, and agent-discoverability audits.
• x402 inspection, directory packaging, and hosted artifact utilities.

The MCP server does not execute paid calls. It returns the endpoint contract, example request, payment requirements, and snippets an agent can run against the hosted API. L402 is exposed as an additional discovery and payment-handoff surface; agents should treat it as discovery-only unless the live L402 document reports a configured issuer.

Install

npx @agentbodega/mcp

Remote MCP clients that support Streamable HTTP can connect directly to:

https://agentbodega.store/mcp

SSE endpoint:

https://agentbodega.store/mcp/sse

Optional environment:

AGENTBODEGA_BASE_URL=https://agentbodega.store

Standalone agent skill:

curl -sS https://raw.githubusercontent.com/agentbodegastore/agentbodega/main/agent-skills/agentbodega/SKILL.md

Network access

This package intentionally uses outbound HTTPS requests at runtime to read AgentBodega's live catalog, x402 discovery document, L402 discovery document, and OpenAPI contract. It does not run install scripts, spawn shells, bundle dependencies, or execute paid calls. By default it connects to https://agentbodega.store.

Claude Desktop

{
  "mcpServers": {
    "agentbodega": {
      "command": "npx",
      "args": ["-y", "@agentbodega/mcp"]
    }
  }
}

Tools

• agentbodega_plan_task - use first when an agent has a plain-language task and wants AgentBodega to choose the cheapest useful route. It calls the free /api/plan planner and returns a recommended endpoint, alternatives, required inputs, examples, and x402 handoff notes. It never executes paid calls.
• agentbodega_search_catalog - use first to find the right paid endpoint. It searches the live directory by text, department/category/tag, and maximum USD price, then returns endpoint summaries with required inputs and example requests. It never executes paid calls.
• agentbodega_get_endpoint - use after search when you know an endpoint key, path, title, or full URL. It returns the full contract: method, URL, price, required inputs, schemas, example request, output example, and long description. It does not call the endpoint.
• agentbodega_call_snippet - use after selecting an endpoint to generate ready-to-edit curl and JavaScript requests with an X-PAYMENT placeholder and x402 verification notes. It does not fetch a challenge, pay, or execute.
• agentbodega_payment_guide - use when an agent needs the AgentBodega payment model before making paid HTTP calls. It explains x402 discovery, L402 handoff status, settlement, blockchain-only balance policy, and optional challenge curl.

Resources

• agentbodega://catalog - compact live catalog.
• agentbodega://x402 - live x402 discovery document.
• agentbodega://l402 - live L402 discovery document.
• agentbodega://openapi - live OpenAPI document.

Development

npm install
npm test