Metadata-Version: 2.5
Name: verantis-mcp
Version: 0.1.0
Summary: MCP server for Verantis — the verified directory for machine payments (x402 & MPP). Find live-verified services and check a wallet before your agent pays.
Project-URL: Homepage, https://verantis.ai
Project-URL: Documentation, https://verantis.ai/api
Project-URL: Repository, https://github.com/m9labs-railscope/verantis-mcp
Author: Verantis
License-Expression: MIT
License-File: LICENSE
Keywords: agent-payments,machine-payments,mcp,model-context-protocol,mpp,stablecoin,usdc,verantis,x402
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# Verantis MCP

**The verified directory for machine payments — as an MCP tool.**

Give any MCP-capable agent (Claude, Cursor, agent frameworks) the ability to check
what it's about to pay *before* it pays. Verantis continuously probes machine-payable
services across **x402** and **MPP**, measures on-chain reputation, and publishes a
recomputable record. This server is a thin client of the public
[Verantis API](https://api.verantis.ai) — standard library only, no dataset needed.

Learn more: **[verantis.ai](https://verantis.ai)** · methodology: [verantis.ai/methodology](https://verantis.ai/methodology)

## Tools

| Tool | What it does |
|------|--------------|
| `find_paid_service` | Search the verified directory (x402 / MPP). Filter by verified-only, price, chain, protocol, category, reputation. |
| `get_service` | Full record + verification provenance for one domain. |
| `check_wallet` | **Pre-payment guard** — pass the recipient wallet a service asked you to pay; get its earned reputation tier, on-chain buyer retention, and which services it fronts. |
| `directory_stats` | Index-level stats: services, verification breakdown, freshness. |

## Install & configure

The server runs over stdio. Easiest is with [`uvx`](https://docs.astral.sh/uv/) (no install step):

**Claude Desktop** (`claude_desktop_config.json`) or any MCP client:

```json
{
  "mcpServers": {
    "verantis": {
      "command": "uvx",
      "args": ["verantis-mcp"]
    }
  }
}
```

Prefer pip? `pip install verantis-mcp`, then use `"command": "verantis-mcp"` with no args.

**Cursor** (`~/.cursor/mcp.json`): same block under `mcpServers`.

Restart your client, and the four tools appear.

## Configuration

| Env var | Default | Purpose |
|---------|---------|---------|
| `VERANTIS_API_BASE` | `https://api.verantis.ai` | Point the client at a different Verantis API. |

## Notes

Informational only; not financial, investment, or legal advice. Classifications
describe what live probes and on-chain reads observed at a point in time and can
change. Reputation is *earned* from real on-chain settlement, not assumed. Verantis
has no rail of its own, no token, and no stake in any listed service.

MIT licensed.
