Axveritas-abvs-gateway
OfficialREADME.md
# Axveritas MCP Server & ABVS-1.0 Gateway
[](https://m8ven.ai/mcp/axveritasprotocol-axveritas-qq00qa?s=readme)
[](https://glama.ai/mcp/servers/axveritasprotocol/axveritas)
Open-source Python **Model Context Protocol (MCP)** server and `ABVS-1.0` verification gateway (`main.py`) for autonomous AI agents on Base Mainnet (Chain ID: 8453).
## Model Context Protocol (MCP) & Live Endpoints
Axveritas implements the **MCP Streamable HTTP / JSON-RPC 2.0 specification** (`protocolVersion: 2024-11-05`) supporting `initialize` and `tools/list` handshakes alongside REST discovery manifests:
- **Remote MCP Server (Streamable HTTP):** `https://axveritas.onrender.com/mcp` (also aliased at `/`)
- **A2A Agent Card:** `https://axveritas.onrender.com/.well-known/agent.json`
- **LLM Specification:** `https://axveritas.onrender.com/llms.txt`
- **Live Treasury & Ledger:** `https://axveritas.onrender.com/v1/treasury`
### Tools Provided
- **`axveritas_preflight_check`** (`POST /v1/preflight`): Pre-flight dead-end URL health check using shared domain-health telemetry (`USDC` or `X-API-Key`).
- **`axveritas_scrape_verified`** (`POST /v1/scrape`): Direct schema-verified web extraction returning clean JSON and an `ABVS-1.0` SHA-256 receipt (`USDC` or `X-API-Key`).
- **`axveritas_verify_relay`** (`POST /v1/relay`): Non-custodial schema verification relay between buyer and worker agents (`1%` protocol toll).
### MCP Client Configuration (`claude_desktop_config.json` / Cursor)
```json
{
"mcpServers": {
"axveritas": {
"url": "[https://axveritas.onrender.com/mcp](https://axveritas.onrender.com/mcp)"
}
}
}
```
---
## Credit Card Subscriptions (`X-API-Key` for Claude, Cursor, Grok & n8n)
Prefer paying by credit card instead of Base Mainnet USDC? Subscribe to a monthly plan to receive an active `X-API-Key` that works across `/v1/preflight`, `/v1/scrape`, and `/v1/relay`:
| Plan | Monthly Price | Included Monthly Quota | Subscribe |
| :--- | :--- | :--- | :--- |
| **Starter** | **$19 / month** | 10,000 Pre-Flight Checks + 500 Verified Scrapes | **[Get Starter Key →](https://buy.stripe.com/9B6cMX8m2bsHaxa8Lc4sE00)** |
| **Builder Pro** | **$49 / month** | 40,000 Pre-Flight Checks + 2,500 Verified Scrapes | **[Get Builder Pro Key →](https://buy.stripe.com/00weV59q6eET0WA4uW4sE01)** |
| **Scale** | **$149 / month** | 150,000 Pre-Flight Checks + 10,000 Verified Scrapes | **[Get Scale Key →](https://buy.stripe.com/8x2bITfOufIX34I6D44sE02)** |
### Quickstart with `X-API-Key` (Python)
```python
import httpx
# 1. Pre-flight check ("Dead-End Sign" — prevents wasted LLM tokens)
check = httpx.post(
"[https://axveritas.onrender.com/v1/preflight](https://axveritas.onrender.com/v1/preflight)",
headers={"X-API-Key": "axv_live_your_key_here"},
json={"target_url": "[https://example.com](https://example.com)"}
).json()
# 2. Direct schema-verified extraction (returns 422 instead of junk HTML if fields are missing)
if check["verdict"] == "PASSABLE":
data = httpx.post(
"[https://axveritas.onrender.com/v1/scrape](https://axveritas.onrender.com/v1/scrape)",
headers={"X-API-Key": "axv_live_your_key_here"},
json={"target_url": "[https://example.com](https://example.com)", "required_keys": ["title", "text"]}
).json()
```
---
## Autonomous Crypto Rail (`x402` Base Mainnet USDC)
Autonomous agents with funded Base Mainnet wallets (`Chain ID: 8453`) can pay per call with canonical USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`) to `0x5922a9b0981db65827AC80F477b5dA3aE133c899` and pass the transaction hash in the `X-Payment-Signature` header.
---
## Self-Hosting & Local Installation
This repository contains the complete FastAPI + MCP JSON-RPC server implementation (`main.py`).
### 1. Clone and Install Dependencies
```bash
git clone [https://github.com/axveritasprotocol/axveritas.git](https://github.com/axveritasprotocol/axveritas.git)
cd axveritas
pip install -r requirements.txt
```
### 2. Run the Server
```bash
uvicorn main:app --host 0.0.0.0 --port 8000
```
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues