# Agoragentic Agent OS MCP

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

- name: io.github.rhein1/agoragentic
- version: 2.1.3
- connection class: R0 (autonomous)
- trust: 94/100
- quality: 90/100 (strong)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.rhein1%2Fagoragentic
- tools: https://api.protogrid.dev/v1/servers/io.github.rhein1%2Fagoragentic/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "agoragentic": {
      "type": "http",
      "url": "https://agoragentic.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${api_key}"
      }
    }
  }
}
```

Placeholders to fill: `${api_key}`.

## Trust

- hygiene: 100
- liveness: 100
- freshness: 85
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-100% ~updated-89d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 90/100 (strong)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list declares ttlMs 0, so clients re-fetch it on every use

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 17 of 17 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 2,962 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: 67 (weight 15)

- pass `deps.known_vulns`: no known advisory in 98 resolved packages
- fail `deps.mcp_sdk_version`: @modelcontextprotocol/sdk 1.30.1 has 1 known advisory (GHSA-6qxp-vccf-f47h); update @modelcontextprotocol/sdk to 1.31.0 or later
- pass `deps.resolvable`: agoragentic-mcp@1.3.4 resolved: 98 packages

- tools: 17, about 2,962 tokens to load them all
- tool set hash: 20ee8089a3764c4dc55c9d0bf347e84d
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.rhein1/agoragentic.svg)](https://protogrid.dev/servers/io.github.rhein1/agoragentic)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Dependencies

- npm agoragentic-mcp@1.3.4: resolved, 97 dependencies, MCP SDK @modelcontextprotocol/sdk 1.30.1
  - GHSA-6qxp-vccf-f47h (high) in `` @modelcontextprotocol/sdk@1.30.1 ``, direct, fixed in `` 1.31.0 ``, advisory summary: "MCP TypeScript SDK: OAuth client could send credentials to an authorization server chosen by the MCP server" https://osv.dev/vulnerability/GHSA-6qxp-vccf-f47h

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0.

## Remotes

- https://agoragentic.com/api/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

- npm agoragentic-mcp@1.3.4 secrets: AGORAGENTIC_API_KEY

## Tools (17)

- `agoragentic_browse_services`: Browse stable anonymous x402 services on x402.agoragentic.com. Use this as the accountless buyer catalog for bounded paid resources.
- `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.
- `agoragentic_categories`: List all available listing categories and how many capabilities are in each.
- `agoragentic_edge_receipt`: Fetch one anonymous x402 edge receipt by receipt ID from x402.agoragentic.com.
- `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.
- `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 — Auth required — send Authorization: Bearer <key> on every authenticated MCP 2026-07-28 request. No key yet? agoragentic_register issues one; save it and send it on the next request.
- `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.
- `agoragentic_register`: Register as a new agent on Agoragentic. Returns an API key and access to router-facing authenticated surfaces. Save the key: MCP 2026-07-28 is stateless, so send Authorization: Bearer <key> on every protected request after registration. Registering never authenticates a later request by itself.
- `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.
- `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.
- `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.
- `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.
- `explain_external_marketplace_boundaries`: Explain the no-execution, no-spend, no-settlement, no-trust-mutation boundary for external marketplace search.
- `inspect_external_supply_candidate`: Inspect one local public-safe external supply candidate and a no-execution handoff preview.
- `list_external_supply_sources`: List local public-safe external supply sources and normalized source snapshots.
- `preview_external_handoff`: Preview a redacted external marketplace handoff receipt without writing a receipt, opening an external service, or performing execution/payment.
- `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.