AgentBodega MCP
OfficialThe AgentBodega MCP server helps agents discover, evaluate, and prepare paid API calls from the AgentBodega marketplace — without executing any paid transactions itself.
Search the live catalog (
agentbodega_search_catalog): Find paid endpoints by text, department/category/tag (e.g.,cloud-status,search), or maximum USD price. Returns summaries with keys, paths, prices, and examples.Get full endpoint details (
agentbodega_get_endpoint): Retrieve the complete contract for an endpoint — HTTP method, URL, price, input/output schemas, and examples — without triggering a paid call.Generate call snippets (
agentbodega_call_snippet): Produce ready-to-edit curl and JavaScript requests with example JSON bodies and anX-PAYMENTplaceholder for x402 payments.Plan a task (
agentbodega_plan_task): Get the cheapest useful route and alternatives for a plain-language task.Understand the payment model (
agentbodega_payment_guide): Learn how AgentBodega's x402 blockchain-settled, per-call payment system works, including discovery, L402 handoff, and balance policies.Access live resources: Read the live catalog (
agentbodega://catalog), x402 discovery (agentbodega://x402), L402 discovery (agentbodega://l402), and OpenAPI spec (agentbodega://openapi) directly as MCP resources.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AgentBodega MCP search the catalog for image generation APIs"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Related MCP server: PreFlight
Install
npx @agentbodega/mcpRemote MCP clients that support Streamable HTTP can connect directly to:
https://agentbodega.store/mcpSSE endpoint:
https://agentbodega.store/mcp/sseOptional environment:
AGENTBODEGA_BASE_URL=https://agentbodega.storeStandalone agent skill:
curl -sS https://raw.githubusercontent.com/agentbodegastore/agentbodega/main/agent-skills/agentbodega/SKILL.mdNetwork 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/planplanner 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 anX-PAYMENTplaceholder 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 testAvailable Tools
4 toolsagentbodega_call_snippetGenerate AgentBodega Call SnippetA
Use this after selecting an endpoint to prepare an HTTP request an agent or user can run outside MCP. It returns curl and JavaScript snippets with the example JSON body, an X-PAYMENT placeholder, and x402 verification notes. It does not fetch a live 402 challenge, spend funds, or execute the paid call.
Inputs: endpoint (required).
agentbodega_get_endpointGet AgentBodega EndpointA
Use this after search_catalog when you know the endpoint key, title, path, or URL and need the complete contract before paying. It returns method, URL, price, category, tags, long description, required inputs, input/output schemas, example request, and output example when available. It does not call the paid endpoint.
Inputs: endpoint (required), includeSchemas.
agentbodega_payment_guideAgentBodega Payment GuideA
Use this when an agent needs to understand how AgentBodega x402 payment discovery and settlement work before making paid HTTP calls. It explains the blockchain-settled per-call model, discovery URLs, balance source of truth, and an optional sample challenge request. It does not validate wallets, create discounts, or perform payments.
Inputs: includeCurl.
agentbodega_search_catalogSearch AgentBodega CatalogA
Use this first when you need to choose an AgentBodega paid data endpoint. It fetches the live directory and returns matching endpoint summaries with key, path, price, category, tags, required inputs, and example request. It never executes paid endpoints or creates x402 payments.
Inputs: limit, query, department, maxPriceUsd.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose in the workflow: search catalog, get endpoint details, payment guidance, and code snippet generation. No overlap or ambiguity.
All tools follow a consistent 'agentbodega_verb_noun' pattern using snake_case, making them predictable and easy to understand.
With 4 tools, the set is well-scoped for the server's goal of guiding users through paid endpoint discovery and preparation. No tool feels extraneous or missing.
The tools cover the entire workflow from search to snippet generation, along with payment guidance. No obvious gaps given the server's stated purpose of not executing paid calls.
Maintenance
Related MCP Connectors
Read-only discovery for exact-commit Agent Skill validation, x402 payment, and signed receipts.
Discover and price paid agent services across the live x402 network, by three.ws.
Search agents and services, and buy Agoreum's checks per call over x402. No account.
Pay-per-call x402 services for agents: risk scoring, DeFi, wallet and market data.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI agents to discover, inspect, and pay for paid HTTP and MCP services using USDC on Solana with a self-custodial wallet.49Apache 2.0
- FlicenseNot gradedqualityCmaintenanceEnables agents to discover and verify paid agent services through x402 payment validation and release gate checks.-
- AlicenseAqualityCmaintenanceEnables agents to search a verified directory of machine-payable services, inspect service and wallet reputation, and get pre-payment checks before spending.44MIT
- AlicenseNot gradedqualityCmaintenanceEnables agents to list, preview, confirm, and pay for HTTP resources via x402, while providing a payment ledger and Binance account/market-data context.MIT