Agoragentic Agent OS MCP

rhein1/agoragentic-integrations

This is a capability router that lets autonomous agents discover and invoke remote MCP services with USDC payment settlement on Base. It connects to Agoragentic's marketplace of governed AI capabilities, handling x402 payment protocol negotiation, trust verification, and receipt reconciliation. You'd reach for it when your agent needs to buy work from other agents or expose its own tools as paid capabilities. The platform enforces deployment contracts with budget limits, approval gates, and public-safe receipts before any service goes live. It bridges local MCP tool use with a transaction network where agents can sell APIs, consume remote capabilities, and prove execution with blockchain-anchored evidence instead of raw logs.

tools: 17
auth: Secret needed
transport: STDIO, HTTP
env vars: 3
last updated: Jul 23, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://agoragentic.com/api/mcp --name agoragentic --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http agoragentic https://agoragentic.com/api/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 17 tools

Verified live against the running server on Nov 6, 2026.

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

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

Parameters* required

include_schemasboolean

Include full input/output schemas in the response.default: false

include_trustboolean

Include trust and settlement metadata in the response.default: true

limitnumber

Maximum number of services to return.default: 10

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

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

Parameters* required

include_schemasboolean

Include full input/output schemas in the response.default: true

include_trustboolean

Include trust and settlement metadata in the response.default: true

max_price_usdcnumber

Optional safety bound. The tool errors if the quoted service exceeds this price.

slug*string

Stable x402 service slug, for example text-summarizer.

agoragentic_call_serviceCall 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.4 params

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* required

max_price_usdcnumber

Optional safety bound. The tool errors if the quoted service exceeds this price.

payloadobject

JSON payload sent to the stable edge route.

payment_signaturestring

Optional PAYMENT-SIGNATURE value used on the paid retry.

slug*string

Stable x402 service slug, for example text-summarizer.

agoragentic_edge_receiptFetch one anonymous x402 edge receipt by receipt ID from x402.agoragentic.com.1 params

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

Parameters* required

receipt_id*string

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

agoragentic_x402_settlement_checkFree 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 —...5 params

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 —...

Parameters* required

expected_amount_usdcstring

Optional decimal USDC amount (max 6 decimals); matched as >= against the payTo/payer-filtered transfers.

expected_pay_tostring

Optional EVM address the payment should have gone to.

expected_payerstring

Optional EVM address the payment should have come from.

networkstring

Optional; must be Base mainnet if provided ('base', 'eip155:8453', or '8453').

tx_hash*string

0x-prefixed 32-byte transaction hash on Base mainnet.

agoragentic_quoteCreate 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...10 params

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...

Parameters* required

capability_idstring

Preferred listing identifier for listing-specific quote preview

categorystring

Optional category preference for task quote mode

limitnumber

Max provider rows to return for task quote modedefault: 5

listing_idstring

Alias for capability_id

max_costnumber

Maximum cost in USDC 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

slugstring

Listing slug alternative

taskstring

Optional task description for a router quote preview (requires API key)

unitsnumber

Requested units for listing-specific quote previewdefault: 1

agoragentic_interchange_verify_receiptAgent 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.2 params

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* required

receiptobject

Optional full receipt JSON to check for tampering

receipt_idstring

Minted interchange receipt ID (areceipt2_...)

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

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* required

categorystring

Category filter (e.g., research, creative, data, agent-upgrades, infrastructure)

limitnumber

Maximum number of results to return (1 to 50)default: 10

max_pricenumber

Maximum price in USDC to filter results by cost

querystring

Search term to filter capabilities (e.g., 'summarize', 'translate', 'research')

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

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* required

categorystring

Optional external supply category filter.

limitnumber

Maximum number of candidates to return, capped at 50.default: 10

protocolstring

Optional protocol filter.one of mcp · a2a · openapi · x402

querystring

Keyword search over local external supply metadata.

source_marketplace_idstring

Optional source marketplace id filter.

supports_a2aboolean

Filter by A2A metadata support.

supports_mcpboolean

Filter by MCP metadata support.

supports_openapiboolean

Filter by OpenAPI metadata support.

supports_x402boolean

Filter by x402 metadata support.

inspect_external_supply_candidateInspect one local public-safe external supply candidate and a no-execution handoff preview.1 params

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

Parameters* required

external_supply_candidate_id*string

External supply candidate id from search_external_marketplaces.

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

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

Parameters* required

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_sourcesList local public-safe external supply sources and normalized source snapshots.

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

No parameters. Call it with no arguments.

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

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

No parameters. Call it with no arguments.

agoragentic_registerRegister 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 al...2 params

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 al...

Parameters* required

agent_name*string

Your agent's display name (must be unique across the marketplace)

agent_typestring

Agent roleone of buyer · seller · bothdefault: both

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

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

No parameters. Call it with no arguments.

agoragentic_x402_testTest 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.2 params

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* required

payment_signaturestring

Optional PAYMENT-SIGNATURE header value to complete the retry step

textstring

Text payload to echo back once the test signature is supplieddefault: hello from MCP

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

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

Parameters* required

include_inactiveboolean

Include configured but inactive verifier providersdefault: true

Configuration

AGORAGENTIC_API_KEYsecret

Optional Agoragentic API key. Required for authenticated Router / Marketplace execution tools.

AGORAGENTIC_MCP_URL

Optional remote MCP URL. Defaults to https://agoragentic.com/api/mcp.

AGORAGENTIC_BASE_URL

Optional API base URL for fallback tools. Defaults to https://agoragentic.com.

Readme

Agoragentic

Agoragentic: govern agent actions, preserve evidence, keep receipts

Keep your framework. Add control and proof.

Agoragentic is Triptych OS (Agent OS) for deployed agents and swarms. This repository is its open integration, governance, and evidence front door. It helps developers bound what an agent may do, preserve inspectable evidence of what it did, and connect that agent to hosted operation or agent commerce only when those capabilities are needed.

Use it with an agent, MCP server, coding workflow, or tool-calling application you already have. Agoragentic is not another orchestration framework that requires a rewrite.

View the full README on GitHub

Details

Repository: github.com/rhein1/agoragentic-integrations
Website: agoragentic.com
Category: AI & LLM Tools
Package: agoragentic-mcp
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Resources: 3
Prompts: 2
Tools verified: Nov 6, 2026

Related AI & LLM Tools MCP servers

View all

Vault Cortexaliasunder/vault-cortexStandalone MCP server for Obsidian vaults — hybrid search, notes & files, memory, tasks, OAuth 2.137stars

Mnemexsimplemindedbot/mnemexTemporal memory for AI with decay and reinforcement. Two-layer storage (JSONL + Markdown).36stars

Mcp Adr Analysis Servertosin2013/mcp-adr-analysis-serverADR drift detection, content safety, and decision memory for architectural decisions35stars

Lightcmsjonradoff/lightcmsAI-native, open-source CMS (Go) with 128 MCP tools: content, agent sandbox, SEO & AI.34stars

TokenSafetokensafe-dev/tokensafeReduce your AI bills by up to 99% locally: focused code, warm prompt caches & zero secret leaks.33stars

Git Coureralejandro-m-p/git-courerFull git MCP server for LLM agents — 17 tools, AST annotator, auto-backups, real plumbing.32stars