Agoragentic Agent OS MCP

by rhein1 · remote · local (npm) · no sign-in to list tools · v2.1.3 · published by GitHub user rhein1

Triptych OS (Agent OS) MCP for governed routing, receipts, and USDC settlement on Base.

Changes · 7

Compare Registry entry

17 tools: 7 change things and 10 only read.

Scanned Oct 21, 2026

Deletes or cancels0Claude Code: deny
Can't be undone0Claude Code: ask
Changes things7Claude Code: ask: see these tools
Only reads10Claude Code: allow: see these tools

2 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http agoragentic https://agoragentic.com/api/mcp

Findings

Matches of fixed checks, with the text they matched.

1 warn1 info

Warnagoragentic_quote
The server marks "agoragentic_quote" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
Matched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The description's first verb is "create": a word for a change.
What this check looks for
InfoThe whole server
The package.json has a "postinstall" script, which npm runs on install.
Matched text
scripts.postinstall: "node scripts/postinstall.js || true"
What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

17 tools

Changes things 7Creates or changes something that can be changed back.Claude Code: ask

agoragentic_call_serviceCall one stable x402 service by slug.No findings
Why it is in this group
- The name "agoragentic_call_service" says "call": a word for a change.
Description, as the server wrote it
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.
Annotations the server declares
- title: Call x402 Service
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
agoragentic_interchange_verify_receiptAgent Commerce Interchange: verify a minted interchange receipt with hash recomputation and signature tamper detection.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it
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.
Annotations the server declares
- title: Interchange Verify Receipt
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
agoragentic_quoteCreate a router-aware quote.1 finding
Why it is in this group
- The description's first verb is "create": a word for a change.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
  The server marks "agoragentic_quote" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
  Matched text
  annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The description's first verb is "create": a word for a change.
  What this check looks for
Description, as the server wrote it
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.
Annotations the server declares
- title: Quote Task or Listing
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
agoragentic_quote_serviceQuote one stable x402 service by slug.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it
Quote one stable x402 service by slug. Returns price, retry behavior, trust metadata, sample input, and the exact payable URL without spending.
Annotations the server declares
- title: Quote x402 Service
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
agoragentic_registerRegister as a new agent on Agoragentic.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it
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.
Annotations the server declares
- title: Register Agent
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
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…No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it
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.
Annotations the server declares
- title: x402 Settlement Check
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
agoragentic_x402_testTest the free x402 402->sign->retry pipeline against Agoragentic without spending real USDC.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it
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.
Annotations the server declares
- title: x402 Pipeline Test
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true

Only reads 10Looks things up and changes nothing.Claude Code: allow

agoragentic_browse_servicesBrowse stable anonymous x402 services on x402.agoragentic.com.No findings
Why it is in this group
- The name "agoragentic_browse_services" says "browse": a word for reading.
Description, as the server wrote it
Browse stable anonymous x402 services on x402.agoragentic.com. Use this as the accountless buyer catalog for bounded paid resources.
Annotations the server declares
- title: Browse x402 Services
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
agoragentic_categoriesList all available listing categories and how many capabilities are in each.No findings
Why it is in this group
- The description's first verb is "list": a word for reading.
Description, as the server wrote it
List all available listing categories and how many capabilities are in each.
Annotations the server declares
- title: List Categories
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
agoragentic_edge_receiptFetch one anonymous x402 edge receipt by receipt ID from x402.agoragentic.com.No findings
Why it is in this group
- The description's first verb is "fetch": a word for reading.
Description, as the server wrote it
Fetch one anonymous x402 edge receipt by receipt ID from x402.agoragentic.com.
Annotations the server declares
- title: Get x402 Edge Receipt
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
agoragentic_searchSearch Agoragentic supply-side listings directly.No findings
Why it is in this group
- The name "agoragentic_search" says "search": a word for reading.
Description, as the server wrote it
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.
Annotations the server declares
- title: Search Capabilities
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
agoragentic_validation_statusList Agoragentic execution verifiers, Argent/Themis high-risk posture, lifecycle states, and any optional external verifier readiness without invoking a paid service.No findings
Why it is in this group
- The name "agoragentic_validation_status" says "status": a word for reading.
Description, as the server wrote it
List Agoragentic execution verifiers, Argent/Themis high-risk posture, lifecycle states, and any optional external verifier readiness without invoking a paid service.
Annotations the server declares
- title: Validation Status
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
explain_external_marketplace_boundariesExplain the no-execution, no-spend, no-settlement, no-trust-mutation boundary for external marketplace search.No findings
Why it is in this group
- The name "explain_external_marketplace_boundaries" says "explain": a word for reading.
Description, as the server wrote it
Explain the no-execution, no-spend, no-settlement, no-trust-mutation boundary for external marketplace search.
Annotations the server declares
- title: Explain External Marketplace Boundaries
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
inspect_external_supply_candidateInspect one local public-safe external supply candidate and a no-execution handoff preview.No findings
Why it is in this group
- The name "inspect_external_supply_candidate" says "inspect": a word for reading.
Description, as the server wrote it
Inspect one local public-safe external supply candidate and a no-execution handoff preview.
Annotations the server declares
- title: Inspect External Supply Candidate
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
list_external_supply_sourcesList local public-safe external supply sources and normalized source snapshots.No findings
Why it is in this group
- The name "list_external_supply_sources" says "list": a word for reading.
Description, as the server wrote it
List local public-safe external supply sources and normalized source snapshots.
Annotations the server declares
- title: List External Supply Sources
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
preview_external_handoffPreview a redacted external marketplace handoff receipt without writing a receipt, opening an external service, or performing execution/payment.No findings
Why it is in this group
- The name "preview_external_handoff" says "preview": a word for reading.
Description, as the server wrote it
Preview a redacted external marketplace handoff receipt without writing a receipt, opening an external service, or performing execution/payment.
Annotations the server declares
- title: Preview External Handoff
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
search_external_marketplacesSearch local public-safe external marketplace supply metadata.No findings
Why it is in this group
- The name "search_external_marketplaces" says "search": a word for reading.
Description, as the server wrote it
Search local public-safe external marketplace supply metadata. Does not call, execute, submit, spend, settle, rank, trust, verify, ready, publish, or expose raw payloads.
Annotations the server declares
- title: Search External Marketplaces
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 2.1.3. Values in angle brackets are yours to fill in.

claude mcp add --transport http agoragentic https://agoragentic.com/api/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json

{
  "permissions": {
    "allow": [
      "mcp__agoragentic__agoragentic_browse_services",
      "mcp__agoragentic__agoragentic_edge_receipt",
      "mcp__agoragentic__agoragentic_search",
      "mcp__agoragentic__search_external_marketplaces",
      "mcp__agoragentic__inspect_external_supply_candidate",
      "mcp__agoragentic__preview_external_handoff",
      "mcp__agoragentic__list_external_supply_sources",
      "mcp__agoragentic__explain_external_marketplace_boundaries",
      "mcp__agoragentic__agoragentic_categories",
      "mcp__agoragentic__agoragentic_validation_status"
    ],
    "ask": [
      "mcp__agoragentic__agoragentic_quote_service",
      "mcp__agoragentic__agoragentic_call_service",
      "mcp__agoragentic__agoragentic_x402_settlement_check",
      "mcp__agoragentic__agoragentic_quote",
      "mcp__agoragentic__agoragentic_interchange_verify_receipt",
      "mcp__agoragentic__agoragentic_register",
      "mcp__agoragentic__agoragentic_x402_test"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as agoragentic. Review it before you use it.

Keep track

Get told when this server's tools change: a new tool, a new description, a new class.

https://anlyon.dev/servers/io.github.rhein1/agoragentic/changes.xml

An Atom feed. Works in any feed reader or Slack's RSS app.

Anlyon alternative

7 of these tools change something. Run those as governed actions.

Declare what an action changes, and Anlyon puts it under a shared limit, binds every approval to the exact request, and grades the outcome. It works on any HTTPS API you can describe as an action.

Anlyon does not run, proxy or govern this MCP server. A tool your own code calls directly is not routed through Anlyon and is not governed by it.

Import an OpenAPI spec →

Compare with other servers for the same product.

Source: MCP Registry · repository. Synced Oct 21, 2026, 18:46 UTC.

For agents: Markdown · JSON · report this listing