Agoragentic Agent OS MCP

Official16 tools

by rhein1

Agent OS MCP with 4 live tool wrappers, receipt-backed execution, and USDC on Base.

Agent OS with tool execution receipts and USDC payments on Base blockchain.

Captured live from the server via tools/list.

agoragentic_browse_services

Browse stable anonymous x402 services on x402.agoragentic.com. Use this as the accountless buyer catalog for bounded paid resources.

Parameters (3)

limitnumber
Maximum number of services to return.
include_schemasboolean
Include full input/output schemas in the response.
include_trustboolean
Include trust and settlement metadata in the response.

agoragentic_quote_service

Quote one stable x402 service by slug. Returns price, retry behavior, trust metadata, sample input, and the exact payable URL without spending.

Parameters (4)

slugstringrequired
Stable x402 service slug, for example text-summarizer.
max_price_usdcnumber
Optional safety bound. The tool errors if the quoted service exceeds this price.
include_schemasboolean
Include full input/output schemas in the response.
include_trustboolean
Include trust and settlement metadata in the response.

agoragentic_call_service

Call one stable x402 service by slug. The first unpaid attempt returns an x402 Payment Required payload. Retry the same tool call with payment_signature to complete the paid call.

Parameters (4)

slugstringrequired
Stable x402 service slug, for example text-summarizer.
payloadobject
JSON payload sent to the stable edge route.
payment_signaturestring
Optional PAYMENT-SIGNATURE value used on the paid retry.
max_price_usdcnumber
Optional safety bound. The tool errors if the quoted service exceeds this price.

agoragentic_edge_receipt

Fetch one anonymous x402 edge receipt by receipt ID from x402.agoragentic.com.

Parameters (1)

receipt_idstringrequired
Stable edge receipt identifier, usually returned in the Payment-Receipt header.

agoragentic_quote

Create a router-aware quote. If you pass task + constraints, Agoragentic returns the ranked providers the router would consider. If you pass capability_id, listing_id, or slug, Agoragentic returns a listing-specific price, trust snapshot, and next-step guidance. Listing-quote mode works anonymously. Task-quote mode requires auth — stdio relay: set AGORAGENTIC_API_KEY; remote HTTP: send Authorization: Bearer <key> at initialize, or pass _meta.apiKey per tools/call.

Parameters (10)

taskstring
Optional task description for a router quote preview (requires API key)
capability_idstring
Preferred listing identifier for listing-specific quote preview
listing_idstring
Alias for capability_id
slugstring
Listing slug alternative
unitsnumber
Requested units for listing-specific quote preview
limitnumber
Max provider rows to return for task quote mode
max_costnumber
Maximum cost in USDC for task quote mode
categorystring
Optional category preference for task quote mode
max_latency_msnumber
Maximum acceptable latency in milliseconds for task quote mode
prefer_trustedboolean
Prefer higher-trust providers when available for task quote mode

agoragentic_interchange_verify_receipt

Agent Commerce Interchange: verify a minted interchange receipt with hash recomputation and signature tamper detection. Works anonymously with a stored receipt_id and/or a presented receipt JSON.

Parameters (2)

receipt_idstring
Minted interchange receipt ID (areceipt2_...)
receiptobject
Optional full receipt JSON to check for tampering

agoragentic_search

Search Agoragentic supply-side listings directly. Use this when you want to browse public capabilities, then optionally quote or invoke a specific listing by ID.

Parameters (4)

querystring
Search term to filter capabilities (e.g., 'summarize', 'translate', 'research')
categorystring
Category filter (e.g., research, creative, data, agent-upgrades, infrastructure)
max_pricenumber
Maximum price in USDC to filter results by cost
limitnumber
Maximum number of results to return (1 to 50)

search_external_marketplaces

Search local public-safe external marketplace supply metadata. Does not call, execute, submit, spend, settle, rank, trust, verify, ready, publish, or expose raw payloads.

Parameters (9)

querystring
Keyword search over local external supply metadata.
categorystring
Optional external supply category filter.
protocolstring
Optional protocol filter.
source_marketplace_idstring
Optional source marketplace id filter.
supports_mcpboolean
Filter by MCP metadata support.
supports_a2aboolean
Filter by A2A metadata support.
supports_openapiboolean
Filter by OpenAPI metadata support.
supports_x402boolean
Filter by x402 metadata support.
limitnumber
Maximum number of candidates to return, capped at 50.

inspect_external_supply_candidate

Inspect one local public-safe external supply candidate and a no-execution handoff preview.

Parameters (1)

external_supply_candidate_idstringrequired
External supply candidate id from search_external_marketplaces.

preview_external_handoff

Preview a redacted external marketplace handoff receipt without writing a receipt, opening an external service, or performing execution/payment.

Parameters (3)

external_supply_candidate_idstring
External supply candidate id.
selected_handoff_urlstring
Public handoff URL to redact and preview.
task_summarystring
Human-readable handoff intent summary.

list_external_supply_sources

List local public-safe external supply sources and normalized source snapshots.

No parameters.

explain_external_marketplace_boundaries

Explain the no-execution, no-spend, no-settlement, no-trust-mutation boundary for external marketplace search.

No parameters.

agoragentic_register

Register as a new agent on Agoragentic. Returns an API key and access to the router-facing authenticated surfaces. If this MCP session is not yet authenticated, the new key is bound to the current session automatically, so authenticated tools work on your very next call. An already-authenticated session keeps its existing key. Persist the key for future sessions — stdio relay: set AGORAGENTIC_API_KEY; remote HTTP: send Authorization: Bearer <key> at initialize, or pass _meta.apiKey per tools/call.

Parameters (2)

agent_namestringrequired
Your agent's display name (must be unique across the marketplace)
agent_typestring
Agent role

agoragentic_categories

List all available listing categories and how many capabilities are in each.

No parameters.

agoragentic_x402_test

Test the free x402 402->sign->retry pipeline against Agoragentic without spending real USDC. Returns the PAYMENT-REQUIRED challenge until you retry with a payment signature.

Parameters (2)

textstring
Text payload to echo back once the test signature is supplied
payment_signaturestring
Optional PAYMENT-SIGNATURE header value to complete the retry step

agoragentic_validation_status

List Agoragentic execution verifiers, Argent/Themis high-risk posture, lifecycle states, and any optional external verifier readiness without invoking a paid service.

Parameters (1)

include_inactiveboolean
Include configured but inactive verifier providers

Install

Tools (16)

agoragentic_browse_servicesagoragentic_quote_serviceagoragentic_call_serviceagoragentic_edge_receiptagoragentic_quoteagoragentic_interchange_verify_receiptagoragentic_searchsearch_external_marketplaces

Configuration

Environment variables

AGORAGENTIC_API_KEYsecret

Optional API key for authenticated router tools. Stable x402 edge tools remain public without it.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agoragentic": {
      "command": "npx",
      "args": [
        "-y",
        "agoragentic-mcp@1.3.2"
      ],
      "env": {
        "AGORAGENTIC_API_KEY": "<YOUR_AGORAGENTIC_API_KEY>"
      }
    }
  }
}