Citely-x402

An open MCP server that gates content & tools behind x402 stablecoin micropayments — with a pluggable content provider and a pluggable payment network (Base today, GOAT Network as the headline integration).

Status: scaffolding (Task 1). See the implementation plan for the full build-out.

Why

Most "agent payments" demos rebuild x402 from scratch. This repo extracts a clean, reusable gateway: an MCP server exposing search_articles + get_article, gated by a free-quota entitlement and then x402 pay-per-call. Two seams keep it generic:

• ContentProvider — bring your own catalog/body; the repo ships a dummy sample provider (no proprietary content).

• PaymentNetwork — swap the x402 network/facilitator/token; ships a Base-Sepolia adapter and a GOAT adapter.

Related MCP server: x402-mcp

Quickstart

pnpm install
cp .env.example .env   # fill in as needed
pnpm test

License

MIT. See LICENSE.

Relation to Citely

This is the open x402/MCP gateway. Citely (private) plugs its own provenance-backed content provider into these same interfaces; the proprietary content, on-chain provenance, and review pipeline stay private.