AgentPay — Pay-per-call AI Microservices

Official34 tools

by ronaldanton · JavaScript

34 pay-per-call AI microservices via x402, USDC on Base, no API keys.

AgentPay MCP Server

AgentPay (help.agentpay/agentpay) provides pay-per-call access to AI + crypto + data microservices via x402 (the 402 Payment Required protocol / MPP). It serves machine-payable endpoints using USDC on Base, wrapping local AI models behind an HTTP 402 paywall for per-request compute payments.

🛠️ Key Features

Machine-payable AI microservices via x402 (402 Payment Required / MPP)
Pay per call using USDC on Base
Open-source reference implementation of the Machine Payments Protocol
Built with Express 5, @x402/express, and Ollama for Gemma models

🚀 Use Cases

Charging AI agents and humans per request for compute
Providing HTTP 402 paywall access without accounts
Delivering AI services served through local models

⚡ Developer Benefits

No accounts, no API keys, and no OAuth
Easier integration for per-request payments using stablecoins
Express 5 + @x402/express integration pattern
Ollama-served Gemma models

⚠️ Limitations

The excerpt only states USDC on Base; other networks or currencies are not described.

Topics

ai-agentsbaseexpressmachine-paymentsmcpmicropaymentsmppollamausdcx402agent-discoveryai-microservicesbase-chaincrypto-paymentsllms-txtmcp-serverpay-per-call

Captured live from the server via tools/list.

summarize

AI text summarization — crisp 250-word summary of any text up to 20k chars ($0.01 USDC per call)

Parameters1

text

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

classify-insurance

Insurance lead classifier — intent, urgency, line of business, confidence ($0.02 USDC per call)

Parameters1

text

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sentiment

Sentiment analysis — positive/negative/neutral with emotions and keywords ($0.02 USDC per call)

Parameters1

text

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

extract

Structured field extraction — key-value pairs from emails, forms, documents ($0.03 USDC per call)

Parameters2

text	string	required
fields	array	optional

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

translate

Text translation — translate to any language ($0.03 USDC per call)

Parameters2

text	string	required
targetLanguage	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string"
    },
    "targetLanguage": {
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

code-review

AI code review — bugs, security, performance, quality score ($0.05 USDC per call)

Parameters2

code	string	required
language	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string"
    },
    "language": {
      "type": "string"
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

insurance-analysis

Full insurance analysis bundle — classification + field extraction + summary in one call ($0.10 USDC per call)

Parameters1

text

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

token-safety

Token safety check - rug pull risk, honeypot detection, liquidity analysis ($0.02 USDC per call)

Parameters2

address	string	required
chain	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    },
    "chain": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

wallet-risk

Wallet risk screening - OFAC sanctions, scam flags, tx patterns ($0.02 USDC per call)

Parameters2

address	string	required
chain	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    },
    "chain": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

web-scrape

Extract clean text from any URL - agents read web pages ($0.01 USDC per call)

Parameters2

url	string	required
max_chars	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "max_chars": {
      "type": "number"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crypto-price

Real-time crypto prices - BTC, ETH, SOL + more ($0.005 USDC per call)

Parameters2

symbols	array	optional
vs_currency	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "vs_currency": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

image-describe

Vision AI - describe any image from URL ($0.03 USDC per call)

Parameters2

image_url	string	required
detail	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "image_url": {
      "type": "string"
    },
    "detail": {
      "type": "string"
    }
  },
  "required": [
    "image_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

defi-yields

DeFi yield data - APY, TVL, protocol info ($0.01 USDC per call)

Parameters2

protocol	string	optional
chain	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "protocol": {
      "type": "string"
    },
    "chain": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

threat-intel

CVE/threat intelligence - vulnerability lookup, severity ($0.02 USDC per call)

Parameters2

cve_id	string	optional
keyword	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "cve_id": {
      "type": "string"
    },
    "keyword": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sanctions-screen

OFAC/EU sanctions screening - entity check ($0.02 USDC per call)

Parameters2

name	string	required
type	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

market-intel

Macro/economic snapshot - GDP, inflation, rates ($0.02 USDC per call)

Parameters1

country

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

on-chain-events

Decoded on-chain events - recent transfers ($0.01 USDC per call)

Parameters2

address	string	required
chain	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string"
    },
    "chain": {
      "type": "string"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

content-safety

Content security scan - PII, toxicity, bias ($0.02 USDC per call)

Parameters1

text

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

agent-reputation

Agent reputation score - endpoint trustworthiness ($0.01 USDC per call)

Parameters1

endpoint_url

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "endpoint_url": {
      "type": "string"
    }
  },
  "required": [
    "endpoint_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

legal-lookup

Legal/regulatory lookup - company registration ($0.03 USDC per call)

Parameters2

query	string	required
jurisdiction	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "jurisdiction": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

news-feed

Real-time news feed - headlines by topic ($0.005 USDC per call)

Parameters2

query	string	required
limit	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

weather-data

Weather data - current conditions and forecast ($0.005 USDC per call)

Parameters2

location	string	required
days	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "location": {
      "type": "string"
    },
    "days": {
      "type": "number"
    }
  },
  "required": [
    "location"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

web-search

Web search - top results for any query with title, url, snippet ($0.01 USDC per call)

Parameters2

query	string	required
max_results	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "max_results": {
      "type": "number"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

memory

Persistent key-value memory scoped to your wallet - agents remember across runs ($0.005 USDC per call)

Parameters4

action	string	required
key	string	required
value	string	required
namespace	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string"
    },
    "key": {
      "type": "string"
    },
    "value": {
      "type": "string"
    },
    "namespace": {
      "type": "string"
    }
  },
  "required": [
    "action",
    "key",
    "value"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

geocode

Geocode place names to lat/lon; reverse geocode coordinates to addresses ($0.005 USDC per call)

Parameters2

query	string	required
reverse	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "reverse": {
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

eth-gas

Ethereum gas prices - rapid/fast/standard/slow in gwei plus ETH spot price ($0.003 USDC per call)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

prediction-market

Polymarket prediction market odds - live probabilities for any topic ($0.01 USDC per call)

Parameters2

query	string	required
limit	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

deep-research

PREMIUM deep research - multi-source web research into a cited markdown report ($0.25 USDC per call)

Parameters2

topic	string	required
depth	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string"
    },
    "depth": {
      "type": "string"
    }
  },
  "required": [
    "topic"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

buy-credits

Prepaid credit pack - one $5 USDC x402 payment mints 600 call-credits (1 credit = $0.01, usable on every endpoint via X-AgentPay-Token; saves 20% vs pay-per-call) ($5 USDC per call)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

buy-credits-starter

Starter credit pack - $1 USDC mints 115 call-credits (+15% bonus) usable on every endpoint via X-AgentPay-Token ($1 USDC per call)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

buy-credits-pro

Pro credit pack - $20 USDC mints 2600 call-credits (+30% bonus) usable on every endpoint via X-AgentPay-Token ($20 USDC per call)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

batch

Batch endpoint - run up to 10 paid service calls in ONE request and one payment (services: summarize, sentiment, extract, translate). Cheaper and faster than paying per call ($0.05 USDC per call)

Parameters1

calls

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "calls": {
      "type": "string"
    }
  },
  "required": [
    "calls"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ad-copy

Ad copy generator - platform-tuned marketing copy (Google/Meta/LinkedIn) with headlines, descriptions, CTAs and A/B variants. 15+ yrs media/ad-sales expertise baked in ($0.10 USDC per call)

Parameters3

brief	string	required
platform	string	optional
count	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "brief": {
      "type": "string"
    },
    "platform": {
      "type": "string"
    },
    "count": {
      "type": "number"
    }
  },
  "required": [
    "brief"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

lead-score

Lead scoring - score inbound leads 0-100 with intent, urgency, budget signals and recommended next action. Built for insurance/ad-sales funnels ($0.08 USDC per call)

Parameters2

lead	object	required
context	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lead": {
      "type": "object",
      "additionalProperties": {}
    },
    "context": {
      "type": "string"
    }
  },
  "required": [
    "lead"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md20 KBView on GitHub

AgentPay — agentpay.help

Machine-payable AI microservices via the 402 Payment Required protocol (x402 / MPP)

No accounts. No API keys. No OAuth. Pay per call in USDC on Base.

AgentPay is an open-source reference implementation of the Machine Payments Protocol — wrapping local AI models behind an HTTP 402 paywall so that AI agents (and humans) can pay for compute on a per-request basis using stablecoins.

Built with Express 5, @x402/express, and Ollama-served Gemma models. Live on Base mainnet with the PayAI facilitator.

Quick Start
Architecture
Services & Pricing
MCP Server
Tech Stack
Deployment
API Reference
Configuration
Contributing
License

Quick Start

Prerequisites

Node.js ≥ 20
Ollama running locally with the required model pulled
A wallet private key (for receiving payments)

1. Clone & install

bash

git clone https://github.com/ronaldanton/x402-shop.git
cd x402-shop
npm install

2. Pull the AI model

bash

ollama pull gemma3:1b
# Or use a larger model for better quality:
# ollama pull gemma4:31b-cloud

3. Configure

bash

cp .env.example .env
# Edit .env — set SELLER_ADDRESS to your wallet address

4. Start the server

bash

npm start
# AgentPay listening on :4021
#   payTo:   0xYourWalletAddress
#   network: eip155:84532 (Base Sepolia testnet)
#   facilitator: https://x402.org/facilitator

5. Test a paid request

bash

# Unpaid request → HTTP 402 (paywall)
curl -s -o /dev/null -w "%{http_code}" -X POST https://agentpay.help/v1/summarize \
  -H 'Content-Type: application/json' \
  -d '{"text":"Machine Payments Protocol lets AI agents pay for API calls using the HTTP 402 status code."}'
# → 402

# Automated test (requires buyer wallet with USDC)
npm run test:402

6. Buy a service (buyer client)

bash

# Set your buyer private key in .env
echo "BUYER_PK=0xYourPrivateKey" >> .env

# Run the buyer script
npm run buyer -- /v1/summarize ./payload.json

Architecture

code

┌─────────────────────────────────────────────────────────────────┐
│                        AgentPay Architecture                   │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌──────────┐    HTTP POST     ┌───────────────────────────┐    │
│  │  Client   │ ──────────────► │      Express 5 Server     │    │
│  │ (Agent /  │   (no auth)     │        (port 4021)        │    │
│  │  Human)   │                 │                           │    │
│  └──────────┘                 │  ┌─────────────────────┐  │    │
│       │                       │  │   Payment Middleware  │  │    │
│       │                       │  │   (@x402/express)    │  │    │
│       │                       │  │                      │  │    │
│       │  ◄── HTTP 402 ───────│  │  • Validates x402    │  │    │
│       │      (paywall)        │  │    payment headers   │  │    │
│       │                       │  │  • Verifies on-chain │  │    │
│       │  ──── signed payment ►│  │    via facilitator   │  │    │
│       │      (USDC)           │  │                      │  │    │
│       │                       │  └──────────┬──────────┘  │    │
│       │  ◄── 200 OK ─────────│             │              │    │
│       │      (result JSON)    │  ┌──────────▼──────────┐  │    │
│       │                       │  │   Service Handlers   │  │    │
│       │                       │  │                      │  │    │
│       │                       │  │  /v1/summarize       │  │    │
│       │                       │  │  /v1/classify-ins    │  │    │
│       │                       │  │  /v1/extract         │  │    │
│       │                       │  └──────────┬──────────┘  │    │
│       │                       └─────────────┼─────────────┘    │
│       │                                     │                   │
│       │                              ┌──────▼──────┐           │
│       │                              │   Ollama     │           │
│       │                              │  (local LLM) │           │
│       │                              │  gemma3:1b   │           │
│       │                              └─────────────┘           │
│       │                                                         │
│  ┌────▼────────────────────────────────────────────────────┐    │
│  │                  Payment Flow (x402)                    │    │
│  │                                                         │    │
│  │  Client ──► HTTP 402 ──► Facilitator ──► On-Chain ──►   │    │
│  │                │         (PayAI)       Base Mainnet     │    │
│  │                ▼                         (USDC)         │    │
│  │          Payment Required                                │    │
│  │          (price + accepts[])                             │    │
│  └─────────────────────────────────────────────────────────┘    │
│                                                                 │
│  ┌─────────────────────────────────────────────────────────┐    │
│  │  Free Endpoints (no paywall)                            │    │
│  │  • /              — Landing page (HTML)                 │    │
│  │  • /health        — Health check                        │    │
│  │  • /stats         — Revenue & usage stats               │    │
│  │  • /.well-known/x402 — Machine-readable service catalog │    │
│  └─────────────────────────────────────────────────────────┘    │
│                                                                 │
│  ┌─────────────────────────────────────────────────────────┐    │
│  │  Data Layer                                             │    │
│  │  • data/ledger.json — Append-only payment ledger        │    │
│  └─────────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────────┘

How it works:

Client sends POST /v1/summarize (or any paid endpoint) — no auth headers needed
Payment middleware intercepts, returns HTTP 402 with pricing info (accepts[])
Client constructs a USDC payment, signs it, attaches X-PAYMENT header
Facilitator verifies the payment on Base mainnet
Middleware grants access → request proceeds to the service handler
Handler calls Ollama, returns AI-generated result as JSON

Services & Pricing

Endpoint	Price	Description
`POST /v1/summarize`	$0.01	AI text summarization — crisp 250-word summary of any text up to 20k chars
`POST /v1/classify-insurance`	$0.02	Insurance lead classifier — intent, urgency, line of business, confidence
`POST /v1/sentiment`	$0.02	Sentiment analysis — positive/negative/neutral with emotions and keywords
`POST /v1/extract`	$0.03	Structured field extraction — key-value pairs from emails, forms, documents
`POST /v1/translate`	$0.03	Text translation — translate to any language
`POST /v1/code-review`	$0.05	AI code review — bugs, security, performance, quality score
`POST /v1/insurance-analysis`	$0.10	Full insurance analysis bundle — classification + field extraction + summary in one call
`POST /v1/token-safety`	$0.02	Token safety check - rug pull risk, honeypot detection, liquidity analysis
`POST /v1/wallet-risk`	$0.02	Wallet risk screening - OFAC sanctions, scam flags, tx patterns
`POST /v1/web-scrape`	$0.01	Extract clean text from any URL - agents read web pages
`POST /v1/crypto-price`	$0.005	Real-time crypto prices - BTC, ETH, SOL + more
`POST /v1/image-describe`	$0.03	Vision AI - describe any image from URL
`POST /v1/defi-yields`	$0.01	DeFi yield data - APY, TVL, protocol info
`POST /v1/threat-intel`	$0.02	CVE/threat intelligence - vulnerability lookup, severity
`POST /v1/sanctions-screen`	$0.02	OFAC/EU sanctions screening - entity check
`POST /v1/market-intel`	$0.02	Macro/economic snapshot - GDP, inflation, rates
`POST /v1/on-chain-events`	$0.01	Decoded on-chain events - recent transfers
`POST /v1/content-safety`	$0.02	Content security scan - PII, toxicity, bias
`POST /v1/agent-reputation`	$0.01	Agent reputation score - endpoint trustworthiness
`POST /v1/legal-lookup`	$0.03	Legal/regulatory lookup - company registration
`POST /v1/news-feed`	$0.005	Real-time news feed - headlines by topic
`POST /v1/weather-data`	$0.005	Weather data - current conditions and forecast
`POST /v1/web-search`	$0.01	Web search - top results for any query with title, url, snippet
`POST /v1/memory`	$0.005	Persistent key-value memory scoped to your wallet - agents remember across runs
`POST /v1/geocode`	$0.005	Geocode place names to lat/lon; reverse geocode coordinates to addresses
`POST /v1/eth-gas`	$0.003	Ethereum gas prices - rapid/fast/standard/slow in gwei plus ETH spot price
`POST /v1/prediction-market`	$0.01	Polymarket prediction market odds - live probabilities for any topic
`POST /v1/deep-research`	$0.25	PREMIUM deep research - multi-source web research into a cited markdown report

All services accept USDC on Base mainnet (chain ID 8453) via the exact payment scheme. Testnet (Base Sepolia) is available via configuration.

MCP Server

AgentPay ships two Model Context Protocol servers so any MCP-capable client (Claude Desktop, Cursor, Windsurf, VS Code, Smithery hosts, …) can call the paid endpoints directly.

1. Remote (Streamable HTTP) — no install, no API keys

The live server exposes all 28 services as MCP tools:

code

POST https://agentpay.help/mcp

Transport: Streamable HTTP (JSON-RPC 2.0)
Auth: none — connecting is free; the underlying endpoint is paid
tools/list → 28 tools, one per service

When a tool is called, the handler performs the real HTTP request and, on HTTP 402, returns the x402 v2 payment challenge (decoded from the PAYMENT-REQUIRED response header) to the calling agent, along with the price and a ready-to-send X-PAYMENT hint. An x402-capable client pays in USDC on Base and retries to receive the result.

Verify the handshake:

bash

curl -s -X POST https://agentpay.help/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | jq '.result.tools | length'
# => 28

Discovery manifests: /.well-known/mcp.json (both servers) and /.well-known/mcp-endpoint.json.

2. Local (stdio) — pays from a local wallet

bash

npx github:ronaldanton/x402-shop mcp-server.js

Env var	Description
`SHOP_URL`	Base URL of the AgentPay deployment (default `https://agentpay.help`)
`BUYER_PRIVATE_KEY`	Hex private key of the buyer wallet — the MCP server signs and settles the x402 payment automatically

This variant settles payments itself, so the MCP client needs no x402 awareness.

Registry

Published to the official MCP Registry as io.github.ronaldanton/agentpay with the remote transport declared:

json

{ "type": "streamable-http", "url": "https://agentpay.help/mcp" }

Tech Stack

Component	Technology
Runtime	Node.js ≥ 20 (ESM)
HTTP Server	Express 5.2
Payment Protocol	`@x402/express` 2.22, `@x402/evm`, `@x402/fetch`, `@x402/extensions`
Blockchain	Base (OP Stack L2), USDC stablecoin
Facilitator	PayAI x402 facilitator (`x402.org/facilitator`)
AI Runtime	Ollama (local inference)
LLM	Gemma 3 1B (default) / Gemma 4 31B (recommended)
Wallet	`viem` (Ethereum client library)
Config	dotenv

Deployment

Local Development

bash

# Base Sepolia testnet (recommended for development)
cp .env.example .env
# Edit .env: PAYMENT_NETWORK=eip155:84532
npm start

Production (Base Mainnet)

bash

# Edit .env for mainnet
PAYMENT_NETWORK=eip155:8453       # Base mainnet
SELLER_ADDRESS=0xYourMainnetWallet
OLLAMA_URL=http://127.0.0.1:11434
MODEL_SUMMARIZE=gemma4:31b-cloud  # Use larger model for quality
MODEL_CLASSIFY=gemma4:31b-cloud
MODEL_EXTRACT=gemma4:31b-cloud

Docker (recommended for production)

dockerfile

FROM node:20-slim
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY src/ ./src/
COPY data/ ./data/
EXPOSE 4021
HEALTHCHECK CMD curl -f https://agentpay.help/health || exit 1
CMD ["node", "src/server.js"]

Environment Variables

Variable	Required	Default	Description
`PORT`	No	`4021`	Server port
`SELLER_ADDRESS`	Yes	—	Wallet address to receive USDC payments
`PAYMENT_NETWORK`	No	`eip155:84532`	Blockchain network (`eip155:8453` for mainnet)
`FACILITATOR_URL`	No	`https://x402.org/facilitator`	x402 facilitator endpoint
`OLLAMA_URL`	No	`http://127.0.0.1:11434`	Ollama API base URL
`MODEL_SUMMARIZE`	No	`gemma3:1b`	Model for summarize endpoint
`MODEL_CLASSIFY`	No	`gemma3:1b`	Model for classify-insurance endpoint
`MODEL_EXTRACT`	No	`gemma3:1b`	Model for extract endpoint
`PUBLIC_URL`	No	—	Public URL for discovery metadata

API Reference

Free Endpoints

`GET /`

Landing page with service catalog and usage stats.

`GET /health`

Health check.

json

{ "ok": true, "ts": "2025-01-01T00:00:00.000Z" }

`GET /stats`

Revenue and usage statistics.

json

{
  "requests_paid": 42,
  "gross_usd": 0.84,
  "by_service": { "summarize": 0.42, "classify-insurance": 0.28, "extract": 0.14 },
  "last_20": [...]
}

`GET /.well-known/x402`

Machine-readable service catalog (Bazaar discovery extension). Use this for automated service discovery by AI agents.

json

{
  "name": "AgentPay",
  "description": "Pay-per-call AI microservices (x402 / MPP)",
  "endpoints": [
    { "path": "/v1/summarize", "method": "POST", "price": "$0.01", "description": "Summarize text (200-20k chars)" },
    { "path": "/v1/classify-insurance", "method": "POST", "price": "$0.02", "description": "Insurance lead classification" },
    { "path": "/v1/extract", "method": "POST", "price": "$0.03", "description": "Structured field extraction" }
  ]
}

Paid Endpoints

All paid endpoints require a valid x402 payment in the X-PAYMENT header. Unpaid requests receive HTTP 402 Payment Required.

`POST /v1/summarize` — $0.01

Summarize text into a concise ~250-word output.

Request:

json

{
  "text": "Your text to summarize (200-20000 characters)..."
}

Response (200 OK):

json

{
  "summary": "The text discusses...",
  "words": 247
}

Errors:

400 — Missing text field or text exceeds 20,000 characters
402 — Payment required (see x402 protocol)
502 — Upstream AI model failed

`POST /v1/classify-insurance` — $0.02

Classify an insurance lead or customer message.

Request:

json

{
  "text": "I was in a car accident last week and need to file a claim urgently..."
}

Response (200 OK):

json

{
  "intent": "claim",
  "urgency": "high",
  "line": "auto",
  "confidence": 0.92
}

Possible values:

intent: quote_request | renewal | claim | complaint | other
urgency: low | medium | high
line: auto | home | life | health | commercial | other

`POST /v1/extract` — $0.03

Extract structured fields from raw text (emails, forms, documents).

Request:

json

{
  "text": "From: john@example.com\nSubject: Policy #12345 renewal\nDear customer, your auto policy expires on March 15...",
  "fields": ["email", "policy_number", "expiry_date"]
}

Response (200 OK):

json

{
  "email": "john@example.com",
  "policy_number": "12345",
  "expiry_date": "March 15"
}

If fields is omitted, all extractable key-value pairs are returned.

Client Library (Buyer)

Use @x402/fetch to automatically handle the 402 → payment → retry flow:

javascript

import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const signer = privateKeyToAccount(process.env.BUYER_PK);
const client = x402Client.fromConfig({
  schemes: [{ network: "eip155:*", client: new ExactEvmScheme(signer) }],
});

const payFetch = wrapFetchWithPayment(globalThis.fetch, client);

// This automatically handles the 402 → payment → retry flow
const res = await payFetch("https://agentpay.help/v1/summarize", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ text: "Your text here..." }),
});

const result = await res.json();
console.log(result.summary);

Contributing

Contributions are welcome! This is an open-source reference implementation of the x402 / MPP protocol.

Development Setup

bash

git clone https://github.com/ronaldanton/x402-shop.git
cd x402-shop
npm install
cp .env.example .env
# Edit .env with your test wallet and Base Sepolia settings
npm start

Adding a New Service

Define the payment middleware entry in src/server.js under the paymentMiddleware() call
Add the route handler after the middleware block
Register the endpoint in /.well-known/x402 discovery
Add to the landing page HTML

Guidelines

Keep it simple. This is a reference implementation — clarity over complexity.
Test on Base Sepolia first. Use the testnet before going to mainnet.
Use @x402/ packages. Don't reinvent payment verification.
Append-only ledger. Never modify data/ledger.json — only append.

Reporting Issues

Open a GitHub issue with:

Steps to reproduce
Expected vs. actual behavior
Environment (Node version, OS, model used)

License

MIT

Resources

x402 Protocol Spec — The Machine Payments Protocol
PayAI Facilitator — Payment verification service
Base Network — OP Stack L2 where USDC payments settle
Ollama — Local LLM inference engine
viem — TypeScript Ethereum client

Install

Tools (34)

summarizeclassify-insurancesentimentextracttranslatecode-reviewinsurance-analysistoken-safety

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://agentpay.help/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agentpay": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://agentpay.help/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

AgentPay MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

summarize

classify-insurance

sentiment

extract

translate

code-review

insurance-analysis

token-safety

wallet-risk

web-scrape

crypto-price

image-describe

defi-yields

threat-intel

sanctions-screen

market-intel

on-chain-events

content-safety

agent-reputation

legal-lookup

news-feed

weather-data

web-search

memory

geocode

eth-gas

prediction-market

deep-research

buy-credits

buy-credits-starter

buy-credits-pro

batch

ad-copy

lead-score

AgentPay — agentpay.help

Table of Contents

Quick Start

Prerequisites

1. Clone & install

2. Pull the AI model

3. Configure

4. Start the server

5. Test a paid request

6. Buy a service (buyer client)

Architecture

Services & Pricing

MCP Server

1. Remote (Streamable HTTP) — no install, no API keys

2. Local (stdio) — pays from a local wallet

Registry

Tech Stack

Deployment

Local Development

Production (Base Mainnet)

Docker (recommended for production)

Environment Variables

API Reference

Free Endpoints

GET /

GET /health

GET /stats

GET /.well-known/x402

Paid Endpoints

POST /v1/summarize — $0.01

POST /v1/classify-insurance — $0.02

POST /v1/extract — $0.03

Client Library (Buyer)

Contributing

Development Setup

Adding a New Service

Guidelines

Reporting Issues

License

Resources

`GET /`

`GET /health`

`GET /stats`

`GET /.well-known/x402`

`POST /v1/summarize` — $0.01

`POST /v1/classify-insurance` — $0.02

`POST /v1/extract` — $0.03