# provenance-mcp

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/apeirontrade/provenance-mcp  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/provenance-mcp

## Description
Wash-traffic risk checks for Algorand x402 endpoints before your agent trusts or pays them.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

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

## Documentation & README

# provenance-mcp

**Check the wash-traffic risk of Algorand x402 endpoints before your agent pays them.**

📊 **[The x402 Trust Index](https://apeirontrade.github.io/provenance-site/)** — our free public
leaderboard: weekly Bazaar Wash Report + resale-authorization audits for 38 API brands.

Roughly half of x402 "agentic payment" activity is artificial — self-dealing loops,
fresh-wallet farms, metronomic bots. Provenance reads the chain and tells your agent
whether an endpoint's revenue is **organic or fabricated**, so it can decide *before*
sending USDC.

## Tools

- **`check_endpoint_risk(address)`** — free quick verdict for any Algorand endpoint
  payTo address: risk level (`low/medium/high/critical`), 0–100 score, and the
  on-chain red flags (distinct-payer count, self-dealing payout loops, wallet ages,
  timing regularity, funding concentration).
- **`provenance_service_info()`** — service + paid-tier info.

Deep forensics are x402-paid on the same API: `/score` $0.05 · `/report` $0.50
(full 8-signal grade + facilitator drift) · `/diligence` $5.00.

## Install

**Claude Code**
```bash
claude mcp add provenance -- npx -y provenance-mcp
```

**Claude Desktop / any MCP client** (`mcpServers` config):
```json
{
  "mcpServers": {
    "provenance": {
      "command": "npx",
      "args": ["-y", "provenance-mcp"]
    }
  }
}
```

Then ask your agent: *“check the wash risk of Algorand endpoint \<ADDRESS\>”*.

## How it works

The hosted Provenance engine indexes USDC (ASA 31566704) payments on Algorand
mainnet, enriches payer wallets (age, first funder, asset diversity, rekey
auth-addr), clusters them (union-find over funding + shared-key links), and runs
8 wash-detection signals. Scores are point-in-time snapshots, anchored on-chain
for tamper-evidence. Methodology: signals, not accusations — a high score means
the revenue pattern is consistent with self-dealing, not that the operator is
guilty of anything.

- Env: `PROVENANCE_API_URL` to point at a different Provenance deployment.
- Free tier: 30 checks/hour/IP.

## Guard your x402 client directly

Building an agent that pays over x402? [`provenance-guard`](https://github.com/apeirontrade/provenance-guard)
wraps any x402-paying fetch and runs this same check automatically **before any
money moves** — one line, zero dependencies:

```typescript
import { createGuard } from "provenance-guard";
const guarded = createGuard().guardedFetch(fetchWithPayment);
```

MIT · Provenance — the trust layer for machine-payable endpoints.