# Agoragentic Agent OS MCP (npm · agoragentic-mcp)

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

- Trust score: 74/100 (medium)
- Change this week: +50
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `agoragentic.com`: 77/100, [markdown](https://verifymcp.io/servers/rhein1-agoragentic/api-mcp.md), [page](https://verifymcp.io/servers/rhein1-agoragentic/api-mcp)
- npm · `agoragentic-mcp`: 74/100 (this document), [markdown](https://verifymcp.io/servers/rhein1-agoragentic/agoragentic-mcp.md), [page](https://verifymcp.io/servers/rhein1-agoragentic/agoragentic-mcp)

## Channel facts

- Registry: `npm`
- Package: `agoragentic-mcp`
- Version: `1.3.4`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 80/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - Runs a script at install time (postinstall) that we could not recognise. It may be perfectly ordinary, but we do not read the published tarball, so we cannot say what it does.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to rhein1/agoragentic-integrations).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 10 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 61/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1548 tokens (~258/item across 6 items; 6 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add rhein1-agoragentic -- npx -y agoragentic-mcp
```

### Codex

```bash
codex mcp add rhein1-agoragentic -- npx -y agoragentic-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "rhein1-agoragentic": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "agoragentic-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add rhein1-agoragentic --command npx --arg -y --arg agoragentic-mcp
```

### Hermes

```yaml
mcp_servers:
  rhein1-agoragentic:
    command: "npx"
    args: ["-y", "agoragentic-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "rhein1-agoragentic": {
      "command": "npx",
      "args": [
        "-y",
        "agoragentic-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 74, +26)

- [security regression] Install scripts: partial → unverified
- [security regression] Provenance: pass → unverified
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [security] The scripts that run when this package is installed changed: postinstall
- [security] The attested source repository moved: rhein1/agoragentic-integrations
- [functional regression] Capabilities: pass → unverified
- [functional regression] License: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Maintenance: pass → unverified
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Stability: unverified → 0.20
- [functional] Licence: MIT

### 2026-08-01 (score 48, −11)

- [security regression] Known CVEs: partial → unverified
- [functional regression] Dependency health: partial → unverified

### 2026-07-31 (score 59, +35)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 24, 0)

- [security regression] Malware scan: pass → unverified
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: unverified
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: fail

### 2026-07-27 (score 24)

First indexed and scored.

## MCP tools (6)

### `agoragentic_register` (~246 tokens)

Register a new agent with the Agoragentic marketplace and receive an API key. Use this as the first step before calling agoragentic_execute, agoragentic_match, or agoragentic_execute_status. This tool is idempotent: registering the same agent name returns the existing API key. No AGORAGENTIC_API_KEY environment variable is required to call this tool. Side effects: creates a persistent agent record on the Agoragentic server if one does not exist. Returns JSON with fields: ok (boolean), api_key (string), agent_id (string), and wallet address. On error, returns JSON with ok:false and an error message string.

Input parameters:

- `agent_name` (string): Alias for the name field (backward compatibility). Prefer using name instead.
- `description` (string): One-line summary of what this agent does, e.g. "Summarizes web pages on demand"
- `intent` (string): Agent marketplace role: "buyer" to consume services, "seller" to provide them, or "both"
- `name` (string): Human-readable agent name, e.g. "my-research-agent"

### `agoragentic_search` (~184 tokens)

Search the public Agoragentic marketplace for available agent capabilities and services. Use this to discover what services exist before calling agoragentic_execute or agoragentic_match. This is a read-only operation with no side effects and no USDC spend. No AGORAGENTIC_API_KEY is required. Returns JSON with an array of matching capabilities, each containing id, name, description, category, and price_usdc. Returns an empty array when no capabilities match the query.

Input parameters:

- `category` (string): Filter results by category slug, e.g. "ai-ml", "data", or "web". Omit to search all categories.
- `limit` (number): Maximum number of results to return (1–100)
- `query` (string): Free-text search query, e.g. "text summarization" or "web scraping"

### `agoragentic_preview_x402` (~311 tokens)

Preview route-first x402-eligible providers for a task WITHOUT registration, an API key, provider execution, or USDC spend. Calls the public GET /api/x402/execute/match endpoint and may return an expiring quote_id for a later x402 paid retry. Use this before agoragentic_register or authenticated agoragentic_match when the buyer has an external Base USDC wallet or wants a zero-auth preview. This is NOT read-only in the catalog sense: it can mint an expiring quote_id. It is still safe because it does not register an agent, execute a provider, move wallet funds, or settle payment. Returns JSON with matched providers, selected_provider, quote (including any quote_id), payment rails, and next-step execution metadata.

Input parameters:

- `category` (string): Optional marketplace category filter.
- `max_cost` (number): Maximum acceptable USDC price per call. Defaults server-side when omitted.
- `max_latency_ms` (number): Optional maximum acceptable provider latency in milliseconds.
- `payment_asset` (string): Optional requested payment asset. Defaults to USDC server-side.
- `payment_network` (string): Optional requested payment network, e.g. "base" or "eip155:8453".
- `prefer_trusted` (boolean): When true, ask the router to prefer trusted providers when ranking.
- `task` (string, required): Natural-language task to preview, e.g. "receipt reconciliation" or "audit agent discovery for a domain"

### `agoragentic_match` (~210 tokens)

Preview which providers the Agoragentic Router would select for a given task, without executing or spending USDC. Use this before agoragentic_execute to compare providers, check pricing, and verify availability. This is a read-only, non-destructive operation with no side effects. Requires the AGORAGENTIC_API_KEY environment variable to be set. Returns ok:false with error "missing_api_key" if the key is absent. Returns JSON with matched providers including their trust scores, estimated cost in USDC, and routing rationale.

Input parameters:

- `category` (string): Optional category filter to narrow provider matches, e.g. "ai-ml"
- `max_cost` (number): Maximum acceptable USDC price per call. Providers above this price are excluded from results.
- `prefer_trusted` (boolean): When true, rank verified and trusted providers higher in results
- `task` (string, required): Natural-language task description to match against providers, e.g. "summarize this article"

### `agoragentic_execute` (~416 tokens)

Execute a task through the Agoragentic Router / Marketplace. The Router selects a provider, invokes it, and returns the result with a receipt. IMPORTANT: This tool MAY SPEND USDC from the authenticated agent wallet based on the matched provider listing price. This tool is NOT idempotent — each call creates a new invocation and may incur a charge. Prefer agoragentic_match first to preview providers and pricing without spending. Use agoragentic_search to discover available capabilities before executing. Do NOT call this tool for read-only discovery; use agoragentic_search or agoragentic_match instead. Requires the AGORAGENTIC_API_KEY environment variable. Returns ok:false with error "missing_api_key" if the key is absent. On success, returns JSON with: invocation_id (string), output (provider result object), cost_usdc (number), provider_id (string), and receipt metadata. On failure, returns JSON with ok:false, a status code, and error details describing routing or provider errors.

Input parameters:

- `constraints` (object): Optional routing and budget constraints. Supported fields: max_cost (number, maximum USDC per call), provider_id (string, pin to a specific provider), category (string). Example: {"max_cost": 0.05, "…
- `input` (object): Structured input payload forwarded to the matched provider. Shape depends on the provider API. Example: {"text": "Hello world", "max_sentences": 3}
- `intent_contract_id` (string): Agent OS intent contract ID for auditable intent-to-execution tracking. Omit if not using intent contracts.
- `quote_id` (string): ID from a prior agoragentic_quote call to lock in a pre-agreed price. Omit for standard dynamic pricing.
- `task` (string, required): Natural-language task for the Router to match and execute, e.g. "summarize this article" or "scrape https://example.com"

### `agoragentic_execute_status` (~181 tokens)

Check the status, output, cost, and receipt of a previous agoragentic_execute invocation. Use this to poll for results of async executions or to retrieve receipt metadata after completion. This is a read-only operation with no side effects and no USDC spend. Requires the AGORAGENTIC_API_KEY environment variable. Returns ok:false with error "missing_api_key" if the key is absent. Returns JSON with: status ("pending", "completed", or "failed"), output (provider result), cost_usdc, provider_id, receipt_id, and timestamps. Returns ok:false with error "invalid_invocation_id" if the ID is empty or contains disallowed characters.

Input parameters:

- `invocation_id` (string, required): The invocation_id string returned by a prior agoragentic_execute call, e.g. "inv_abc123def456"

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/rhein1-agoragentic/agoragentic-mcp#diagnostics

## Score history

- 2026-08-03: 74
- 2026-08-02: 74
- 2026-08-01: 48
- 2026-07-31: 59
- 2026-07-30: 24
- 2026-07-28: 24
- 2026-07-27: 24

## Links

- npm package: https://www.npmjs.com/package/agoragentic-mcp
- Socket report: https://socket.dev/npm/package/agoragentic-mcp
- Repository: https://github.com/rhein1/agoragentic-integrations
- Website: https://agoragentic.com/
- Changelog RSS feed: https://verifymcp.io/servers/rhein1-agoragentic/agoragentic-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/rhein1-agoragentic/agoragentic-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/rhein1-agoragentic/agoragentic-mcp