X402 A2a Hub

by garyedgington

321 downloads
Not rated
GitHub

About

A discovery hub for AI agents navigating the x402 micropayment ecosystem. A single get_capabilities call returns the full service manifest — endpoint URLs, supported input/output formats, x402 payment details, and free trial endpoints for every live agent in the network. Use this

Details

Author
garyedgington
Downloads
321
Categories
Other

- Unified JSON capability manifest with endpoint, payment, and trial URL data.
- Free to query with no payment gate.
- Supports agent-driven service chaining with independent x402 settlement.
- Exposes GET /.well-known/x402 and GET /llms.txt for LLM/agent discovery.
- Health check endpoint at GET /health.
- Built with FastAPI+Uvicorn, no Claude API dependency.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name X402 A2a Hub
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Access the live service at https://project-a2a-production.up.railway.app. Use the discovery endpoints to retrieve the capability manifest, protocol discovery document, or plain-text service descriptions. No configuration or API key is required.

get_capabilities

Retrieve the full capability manifest for the x402 micropayment task market. Returns every available service with its endpoint URL, supported input/output formats, x402 payment details (network, price in USD, asset contract), and free trial endpoint. Use this to discover what the pipeline can do before calling specific tools.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "x402 a2a hub": {
            "x402-a2a-hub": {
                "url": "https://project-a2a-production.up.railway.app/mcp/sse"
            }
        }
    }
}

McpServers

{
    "x402-a2a-hub": {
        "url": "https://project-a2a-production.up.railway.app/mcp/sse"
    }
}

x402 A2A Hub

Capability discovery hub for the x402 micropayment task market. Exposes a unified manifest of all live services so agents can discover, price-check, and chain calls without hardcoded URLs.

Live service: https://project-a2a-production.up.railway.app

---

Discovery endpoints

| Endpoint | Description |
|---|---|
| GET /v1/capabilities | Full JSON capability manifest — all services, endpoints, payment details, trial URLs |
| GET /.well-known/x402 | x402 protocol discovery document |
| GET /llms.txt | Plain-text service descriptions optimised for LLM/agent semantic search |
| GET /health | Health check — {"status":"ok","service":"a2a-hub"} |

---

Capability manifest

GET /v1/capabilities returns a structured manifest of every service in the pipeline:

{
  "version": "1.0",
  "provider": "Gary Edgington",
  "description": "x402 micropayment task market — data transformation and validation pipeline.",
  "services": [
    {
      "id": "formatter",
      "name": "Data Formatter",
      "description": "Converts CSV to JSON, XML to JSON, or Markdown to HTML.",
      "endpoint": "https://project-formatter-production.up.railway.app/v1/format",
      "trial_endpoint": "https://project-formatter-production.up.railway.app/v1/format/trial",
      "payment": { "scheme": "x402", "network": "eip155:8453", "price_usd": 0.005 }
    },
    {
      "id": "schema-checker",
      "name": "JSON Schema Checker",
      "description": "Validates JSON payloads against JSON Schema Draft 7.",
      "endpoint": "https://projectx402-production.up.railway.app/v1/schema-check",
      "trial_endpoint": "https://projectx402-production.up.railway.app/v1/schema-check/trial",
      "payment": { "scheme": "x402", "network": "eip155:8453", "price_usd": 0.005 }
    }
  ]
}

---

Pipeline

Agents can chain services discovered via this hub:

Raw Input → Formatter (/v1/format) → Schema Checker (/v1/schema-check)

Each hop settles independently on Base mainnet via x402. The A2A hub itself has no payment gate — it is permanently free to query.

---

Stack

- FastAPI + Uvicorn
- No Claude API dependency (pure manifest/routing logic)
- Deployed on Railway

---

Related

- Data Formatter: https://project-formatter-production.up.railway.app
- MCP SSE: /mcp/sse — listed on Smithery
- Schema Checker: https://projectx402-production.up.railway.app

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.