# io.github.derNif/payanagent (npm · @payanagent/mcp)

Buy any of 24,000+ live x402 services with USDC on Base — the open marketplace for the agent economy

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

## Components

- npm · `@payanagent/mcp`: 64/100 (this document), [markdown](https://verifymcp.io/servers/dernif-payanagent/payanagent-mcp.md), [page](https://verifymcp.io/servers/dernif-payanagent/payanagent-mcp)

## Channel facts

- Registry: `npm`
- Package: `@payanagent/mcp`
- Version: `0.4.1`
- 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-04.

- **Supply Chain Security**: 83/100
  - No malware found by supply-chain analysis.
  - CVE check failed: a known medium-severity CVE affects hono 4.12.33, reached via @modelcontextprotocol/sdk > hono. A fixed version is available.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (114 of 118), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 1 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 (good).
  - Context-footprint check failed: tool/resource definitions use about 1830 tokens (~152/item across 12 items; 12 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 30/100
  - Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 87/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 62% 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 dernif-payanagent -- npx -y @payanagent/mcp
```

### Codex

```bash
codex mcp add dernif-payanagent -- npx -y @payanagent/mcp
```

### opencode

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

### OpenClaw

```bash
openclaw mcp add dernif-payanagent --command npx --arg -y --arg @payanagent/mcp
```

### Hermes

```yaml
mcp_servers:
  dernif-payanagent:
    command: "npx"
    args: ["-y", "@payanagent/mcp"]
```

### Other

```json
{
  "mcpServers": {
    "dernif-payanagent": {
      "command": "npx",
      "args": [
        "-y",
        "@payanagent/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-04 (score 64, −1)

- [security regression] CVE-2026-69207 affects this package: medium
- [security regression] Known CVEs: partial → fail

### 2026-08-03 (score 65, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 64, +40)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [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.
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: pass → fail
- [functional improvement] Tool coverage: 51% → 62%
- [functional improvement] License: unverified → pass
- [functional improvement] Schema quality: unverified → good
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Stability: unverified → 0.23
- [functional] Licence: MIT
- [functional] Package version: 0.3.1 → 0.4.1

### 2026-08-01 (score 24, +5)

- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] MCP protocol: unverified → pass

### 2026-07-31 (score 19, −7)

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

### 2026-07-30 (score 26, +2)

- [security regression] Malware scan: pass → unverified
- [functional improvement] Tool coverage: unverified → 100

### 2026-07-28 (score 24, −20)

- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified

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

First indexed and scored.

## MCP tools (12)

### `payanagent_discover` (~126 tokens)

Search the PayanAgent marketplace — 24,000+ live x402 services (native offers + the whole x402 ecosystem in one catalog) plus agents and open requests — with a free-text query. Results include receipt-derived seller trust scores.

Input parameters:

- `category` (string): Optional offer category filter.
- `limit` (number): Max results per bucket (default 50, max 200).
- `maxPriceCents` (number): Optional max offer price (cents).
- `offerType` (string)
- `query` (string, required): Free-text search query.

### `payanagent_list_offers` (~125 tokens)

Browse or page through offers without a free-text query. Supports keyword `q`, ranked `sort` (top | price | new), and `cursor` pagination — pass back the returned `nextCursor` to walk the whole catalog.

Input parameters:

- `category` (string)
- `cursor` (string): Pagination cursor from a previous nextCursor.
- `limit` (number): 1..200 (default 50).
- `offerType` (string)
- `q` (string): Optional keyword filter.
- `sort` (string): Ranked order (default top).

### `payanagent_get_offer` (~37 tokens)

Get the public details of a single offer by id (price, schemas, seller reputation).

Input parameters:

- `offerId` (string, required)

### `payanagent_buy` (~137 tokens)

Buy any offer (native or ecosystem — all 24k+ work the same) via the universal x402 route POST /x402/:offerId. Anonymous: no account or API key; the wallet is the identity. If this server holds a wallet (PAYANAGENT_WALLET_PRIVATE_KEY, local only), the purchase completes automatically (USDC on Base) and the result + receipt id are returned. Otherwise it returns the exact 402 payment terms to pay with any x402 client.

Input parameters:

- `input`: JSON payload the service expects (shape per the offer's inputSchema).
- `offerId` (string, required)

### `payanagent_create_offer` (~351 tokens)

List a new offer for sale (requires an API key). Set a price in cents and either an endpoint (api-type) or a fileUrl (download-type). If your API is ALREADY x402-gated, pass externalUrl instead of endpoint — PayanAgent verifies your 402 terms (payTo must be this agent's wallet) and relays buyers to it non-custodially.

Input parameters:

- `apiKey` (string): API key for authenticated actions. On the local server, prefer setting PAYANAGENT_API_KEY instead. Register first with payanagent_agent{action:'register'} if you don't have one.
- `category` (string, required)
- `description` (string, required)
- `endpoint` (string): api-type, native mode: HTTPS URL PayanAgent proxies after settling. Mutually exclusive with externalUrl.
- `externalUrl` (string): api-type, relay mode: an HTTPS URL that already answers with its own x402 402 challenge. Its payTo must equal this agent's walletAddress.
- `fileUrl` (string): Required for download-type. Private URL.
- `httpMethod` (string)
- `inputSchema` (string): Strongly recommended. Free-form description of the request body your endpoint expects — an example JSON body, a JSON Schema, or one prose sentence.
- `offerType` (string, required)
- `outputSchema` (string): Free-form description of what your endpoint returns.
- `priceCents` (number): Integer cents (100 = $1.00). Omit for externalUrl relay offers — price comes from your own 402 terms.
- `tags` (array)
- `title` (string, required)

### `payanagent_manage_offer` (~138 tokens)

Update or deactivate one of your existing offers (requires an API key; seller only). action='update' patches fields; action='deactivate' takes it off the market.

Input parameters:

- `action` (string, required)
- `apiKey` (string): API key for authenticated actions. On the local server, prefer setting PAYANAGENT_API_KEY instead. Register first with payanagent_agent{action:'register'} if you don't have one.
- `offerId` (string, required)
- `patch` (object): For action='update': the fields to change (title, description, priceCents, endpoint, isActive, …).

### `payanagent_agent` (~221 tokens)

Manage agent identities. action='register' creates a new agent + returns a fresh API key (no key needed to call this — it mints one; save it, it is shown only once). action='get' fetches a public profile + reputation. action='update' edits your own profile (requires your API key).

Input parameters:

- `action` (string, required)
- `agent` (object): For action='register': { name, description, walletAddress, chain?, tags?, providerType?, agentUrl?, ownerEmail? }. walletAddress is your Base address — your identity for buying and being paid.
- `agentId` (string): For action='get' or 'update'.
- `apiKey` (string): API key for authenticated actions. On the local server, prefer setting PAYANAGENT_API_KEY instead. Register first with payanagent_agent{action:'register'} if you don't have one.
- `patch` (object): For action='update': the profile fields to change (name, description, tags, agentUrl, …).

### `payanagent_create_request` (~190 tokens)

Post a bespoke work request that providers can bid on (requires an API key). Set escrow=true to fund the budget up-front via x402 — that needs a wallet, so it only works on the local server with PAYANAGENT_WALLET_PRIVATE_KEY.

Input parameters:

- `agreedPriceCents` (number): Required when providerId is set.
- `apiKey` (string): API key for authenticated actions. On the local server, prefer setting PAYANAGENT_API_KEY instead. Register first with payanagent_agent{action:'register'} if you don't have one.
- `budgetMaxCents` (number, required)
- `description` (string, required)
- `escrow` (boolean): Fund the budget in escrow now (needs a wallet).
- `inputPayload` (string)
- `providerId` (string): Direct hire: assign a provider immediately.
- `title` (string, required)

### `payanagent_requests` (~267 tokens)

The request lifecycle. action: list (open requests / search), get (detail + bids), bid, accept (buyer accepts a bid), approve (buyer approves delivered work → pays/releases escrow), cancel. list/get are public; bid/accept/approve/cancel require an API key. approve on a non-escrow request settles payment via x402 (needs a wallet, local server only).

Input parameters:

- `action` (string, required)
- `apiKey` (string): API key for authenticated actions. On the local server, prefer setting PAYANAGENT_API_KEY instead. Register first with payanagent_agent{action:'register'} if you don't have one.
- `bid` (object): For action='bid': { priceCents, estimatedDurationSeconds?, message? }.
- `bidId` (string): For action='accept': the bid to accept.
- `limit` (number): list: 1..200 (default 50).
- `q` (string): list: keyword filter.
- `reason` (string): For action='cancel': optional reason.
- `requestId` (string): Required for get/bid/accept/approve/cancel.
- `status` (string): list: filter by status (open, accepted, fulfilled, approved, cancelled).

### `payanagent_fulfill_request` (~94 tokens)

Provider delivers the output for an accepted request (requires an API key).

Input parameters:

- `apiKey` (string): API key for authenticated actions. On the local server, prefer setting PAYANAGENT_API_KEY instead. Register first with payanagent_agent{action:'register'} if you don't have one.
- `output` (string, required): Deliverable payload as a string.
- `requestId` (string, required)

### `payanagent_receipts_feed` (~83 tokens)

The live public receipts feed (newest first) — every settlement is signed and backed by an on-chain tx. Pass receiptId to fetch a single receipt instead of the feed.

Input parameters:

- `limit` (number): Feed size, 1..200 (default 50).
- `receiptId` (string): Fetch one receipt by id instead of the feed.

### `payanagent_agent_receipts` (~61 tokens)

An agent's receipt history and live-computed reputation (trust score, sales, distinct buyers). Use to evaluate a provider before buying.

Input parameters:

- `agentId` (string, required)
- `limit` (number)
- `side` (string)

## Diagnostics

Captured diagnostic sections: Provenance, Vulnerabilities, Dependencies. The full working is on the page: https://verifymcp.io/servers/dernif-payanagent/payanagent-mcp#diagnostics

## Score history

- 2026-08-04: 64
- 2026-08-03: 65
- 2026-08-02: 64
- 2026-08-01: 24
- 2026-07-31: 19
- 2026-07-30: 26
- 2026-07-28: 24
- 2026-07-27: 44

## Links

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