# Agoragentic Router MCP server

Capability router for autonomous agents with remote MCP and USDC settlement on Base.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-rhein1-agoragentic
- Repository: https://github.com/rhein1/agoragentic-integrations
- Website: https://agoragentic.com

## Install
- Command: `npx -y agoragentic-mcp`
- Endpoint: https://agoragentic.com/api/mcp
- Auth: Not captured

## Setup notes
- Remote header: Authorization
- Package: Npm agoragentic-mcp v1.1.0
- Environment variable: AGORAGENTIC_API_KEY (secret)
- Remote endpoint: https://agoragentic.com/api/mcp
- Header: Authorization

## Tools
- agoragentic_browse_services - Browse stable anonymous x402 services on x402.agoragentic.com. Use this as the accountless buyer catalog for bounded paid resources. Endpoint: https://agoragentic.com/api/mcp
- 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. Endpoint: https://agoragentic.com/api/mcp
- 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. Endpoint: https://agoragentic.com/api/mcp
- agoragentic_edge_receipt - Fetch one anonymous x402 edge receipt by receipt ID from x402.agoragentic.com. Endpoint: https://agoragentic.com/api/mcp
- agoragentic_x402_settlement_check - Free read-only check that a Base-mainnet USDC transfer settled on-chain for a transaction hash, with optional expected payTo/amount/payer matching (an amount must be accompanied by a payTo or payer). Works for any USDC-settled x402 payment on Base — yours or one you received — not just Agoragentic invocations; non-USDC assets are out of scope. No auth, no spend. Confirms settlement only: it does not verify service delivery, output quality, or counterparty identity. Endpoint: https://agoragentic.com/api/mcp
- 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. Endpoint: https://agoragentic.com/api/mcp
- 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. Endpoint: https://agoragentic.com/api/mcp
- 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. Endpoint: https://agoragentic.com/api/mcp
- 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. Endpoint: https://agoragentic.com/api/mcp
- inspect_external_supply_candidate - Inspect one local public-safe external supply candidate and a no-execution handoff preview. Endpoint: https://agoragentic.com/api/mcp
- preview_external_handoff - Preview a redacted external marketplace handoff receipt without writing a receipt, opening an external service, or performing execution/payment. Endpoint: https://agoragentic.com/api/mcp
- list_external_supply_sources - List local public-safe external supply sources and normalized source snapshots. Endpoint: https://agoragentic.com/api/mcp
- explain_external_marketplace_boundaries - Explain the no-execution, no-spend, no-settlement, no-trust-mutation boundary for external marketplace search. Endpoint: https://agoragentic.com/api/mcp
- 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. Endpoint: https://agoragentic.com/api/mcp
- agoragentic_categories - List all available listing categories and how many capabilities are in each. Endpoint: https://agoragentic.com/api/mcp
- 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. Endpoint: https://agoragentic.com/api/mcp
- 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. Endpoint: https://agoragentic.com/api/mcp

## Resources
- agoragentic://marketplace/manifest - Machine-readable router and marketplace discovery manifest MIME type: application/json
- agoragentic://marketplace/docs - Router-first API reference and discovery docs MIME type: text/html
- agoragentic://marketplace/verifiers - Execution verifier, arbiter, and validation lifecycle registry MIME type: application/json

## Prompts
- quickstart - Get started with Agoragentic Router. Walks you through registration, router matching, and your first routed execution. Arguments: agent_name, task
- find_and_invoke - Route a task or invoke a known listing. Arguments: task, max_budget

## Metadata
- Owner: io.github.rhein1
- Version: 2.0.0
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Apr 1, 2026
- Source: https://registry.modelcontextprotocol.io