Humans read free. Machines pay.
A toll you put in front of a site. AI agents and crawlers pay a fraction of a cent in USDC to read or cite a page, it settles straight to the author's own wallet, and people read free.
Power your agent
पब्लिशर की अपनी कमांड। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
npx -y @naulon/[email protected]Claude Code में लोकल कमांड के लिए इंस्टॉल लिंक नहीं है। नीचे दी गई कमांड कॉपी करें और टर्मिनल में चलाएँ।
claude mcp add naulon-wayfarer-mcp -- npx -y @naulon/wayfarer-mcp@0.8.0टर्मिनल में चलाएँ।
{ "mcpServers": { "naulon-wayfarer-mcp": { "command": "npx", "args": [ "-y", "@naulon/[email protected]" ] } }}claude_desktop_config.json
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
A toll you put in front of a site. AI agents and crawlers pay a fraction of a cent in USDC to read or cite a page, it settles straight to the author's own wallet, and people read free.
Model Context Protocol server that lets any LLM discover, quote, pay, and cite naulon-tolled sources — BYO wallet, local stdio, the wayfarer brain in-process.
People should read for free. Language models now read writing at scale and pay nothing for
it: the cost lands on the author and the benefit on the crawler. naulon changes that one
exchange. A human request passes straight through, untouched. A machine request gets
402 Payment Required and settles a tiny USDC payment before it reads. The fare is the
naulon, the old coin you paid to cross.
The toll is what keeps the work open: machines pay for the free human read.
Pick the door that fits how your site runs. Every one of them tolls the same way and settles to the same wallets.
You need Docker and Node 22 for the one-off setup command. The image is public, with no registry login.
curl -O https://raw.githubusercontent.com/naulonapp/naulon/main/docker-compose.yml
npx -p @naulon/sdk naulon init # asks a few questions, writes .env and config/credits.json
docker compose up -d # gate on :8402, console on :8403 (loopback only)
init writes a generated first password for the console into .env (mode 0600). Sign in at
http://localhost:8403 as admin, and the console asks you to choose a new one. It runs in
mock settlement until you add a wallet, so nothing moves while you look around. Pinning a
version, exposing the console, and moving to real settlement are in
docs/operating.md.
git clone https://github.com/naulonapp/naulon.git && cd naulon
make install
make demo # offline: a stub site, the gate, an agent that pays, a settlement pass
make dev runs the same stack live (stub origin :3000, gate :8402, console :8403) so you
can drive it yourself. make help lists every target.
Two commands, both offline. doctor reads your .env, checks the credits source and probes
the gate: a browser must read free and an agent must get a 402. selftest goes the rest of
the way, paying the 402, reading the article, checking the citation licence it got back, and
proving the same payment cannot be replayed.
npx -p @naulon/sdk naulon doctor
npx -p @naulon/sdk naulon selftest
✓ manifest self-describing toll at /essays/ · read 1000 atomic
✓ human browser UA → HTTP 200, straight through
✓ quote 402 · 1000 atomic → 0x1111…1111
✓ pay HTTP 200 · settled with a payment-response
✓ licence citation licence for "on-stillness" naming 1 payee(s)
✓ replay the spent payment bought nothing a second time
✓ citation 5000 atomic (5× a read) · paid, HTTP 200
Or watch it by hand against make dev:
curl -A 'Mozilla/5.0' -H 'accept: text/html' localhost:8402/essays/on-stillness # 200, free
curl -A 'python-requests' localhost:8402/essays/on-stillness # 402, the bill
flowchart LR
Req([Request]) --> Cls{Human or<br/>machine?}
Cls -->|human| Free[[Free read,<br/>untouched]]
Cls -->|machine| Bill[402 Payment Required<br/>price · wallets · nonce]
Bill --> Sign[Agent pays in USDC<br/>and retries]
Sign --> Verify{Verified by<br/>Circle Gateway?}
Verify -->|yes| Serve[[The page and a<br/>citation licence]]
Verify -->|replayed or invalid| Bill
linkStyle 0 stroke-width:2px
linkStyle 1 stroke:#3fb950,stroke-width:2px
linkStyle 2 stroke:#d29922,stroke-width:2px
The classifier is tuned to favour people. Mistaking a reader for a machine paywalls a person and breaks the whole promise; mistaking a machine for a person loses a fraction of a cent. An agent that says it will pay is trusted over user-agent guessing.
Attribution is the payout rule. An article's credits, who wrote it and in what proportion,
are how the money splits. A credit can be a collective that splits again among its members,
all the way down. This is the real graph from examples/cascade,
resolved by the split algorithm in @naulon/shared:
flowchart TD
Toll["Toll paid: $0.006"]
Toll -->|weight 3| Desk["the-immunology-desk<br/><i>collective</i> · $0.0045"]
Toll -->|weight 1| Mira["mira · $0.0015"]
Desk -->|weight 1| Oko["okonkwo · $0.0015"]
Desk -->|weight 2| Bench["the-bench-team<br/><i>collective</i> · $0.0030"]
Bench -->|equal| Pet["petrova · $0.0015"]
Bench -->|equal| Had["haddad · $0.0015"]
Every leaf is a direct payout to an author, tracked per (event, author). The collectives
never hold money; they are only a rule for how a cut divides. Sub-cent shares accrue until
they clear MIN_PAYOUT_USDC, so nothing is paid twice or lost; make settle runs one
settlement pass over the ledger.
The gate describes itself. Every 402 carries Link: </.well-known/x402>; rel="payment",
and GET /.well-known/x402 returns the terms an agent needs: the paths that toll, the read
and citation price, the network and asset, and where to verify a licence. It names no wallet;
payTo is resolved per article at payment time.
The Wayfarer is a research agent that pays: it ranks candidates by
relevance per dollar, buys under a budget down to a relevance floor, reuses what it already
holds, and logs why for every choice. Against make dev:
TOLLGATE_URL=http://localhost:8402 CATALOG_URL=http://localhost:3000/catalog \
make wayfarer TOPIC="payment and passage"
[PAY] the-naulon — relevance 1.00 @ $0.005000 (density 200); $0.095000 left
[SKIP] on-stillness — relevance 0.00 below floor 0.35
✓ paid $0.005000 for the-naulon → 🎫 license verified
It runs offline on mock settlement and a keyword appraisal; set OPENAI_API_KEY for model
appraisal and answers. @naulon/wayfarer-mcp exposes the same agent
as an MCP server, and docs/buying.md covers both.
Everything above runs on mock settlement. Real money moves through the Circle Gateway
batching SDK (@circle-fin/x402-batching), Arc first:
make generate-wallets # a buyer and an author wallet; fund the buyer from the Circle faucet on Arc
# then in .env: PAYMENT_MODE=gateway and BUYER_PRIVATE_KEY
payTo. x402 settles to a single address, so the on-chain leg pays the
article's primary author; the attribution layer pays the rest of the split onward. The split
is always recorded.SETTLEMENT_NETWORK picks the chain: arcTestnet (the default), baseSepolia
or base. The full Circle chain registry, Arc mainnet included, lives in
networks.ts, and chains turn on as live settlement is
verified on each.The headers (PAYMENT-REQUIRED, payment-signature, PAYMENT-RESPONSE) and the Arc constants
match circlefin/arc-nanopayments, so a stock Gateway client pays this gate unmodified.
sequenceDiagram
autonumber
participant A as Agent
participant G as Gate
participant C as Circle Gateway (Arc)
participant Au as Author wallet
A->>G: GET /essays/the-naulon
G-->>A: 402 · price · payTo · nonce
Note over A: decide under budget
A->>C: pay (deposit-backed, gasless)
A->>G: retry with payment-signature
G->>C: verify and settle
C->>Au: USDC, buyer to author
G-->>A: 200 · the page and a citation licence
The dependency graph points one way: sdk at the bottom, then shared, then enforce, with
the runnable pieces on top. Nothing lower reaches up.
Nothing here is tied to one publisher. You wire up two things:
ORIGIN_URL: the site the gate sits in front of.CREDITS_API_URL at your
CMS, ship a static credits.json, or implement the one-method CreditsResolver.examples/meridian is a complete adapter for a fictional essays site, and
examples/cascade is a second one with a different origin, path and a deeper
credits graph, on the same core with no code changed. The gate can also POST a signed
settlement.completed to your own endpoint after every paid read; @naulon/sdk verifies it.
The gate is built to face the internet: every 402 carries a single-use, HMAC-signed nonce
bound to the price and payee, so a captured payment cannot be replayed or moved to a dearer
page. Requests are rate limited per client, hop-by-hop and internal headers are stripped before
anything reaches your origin, and credits are validated before any wallet becomes a payTo.
The console is not meant to face the internet: it can rewrite who gets paid, so it binds to
loopback and refuses to serve on a wider address without a credential. The full list is in
docs/operating.md.
Found a vulnerability? Report it privately as SECURITY.md describes, not in a public issue.
Issues and pull requests are welcome. CONTRIBUTING.md covers the setup,
the conventions and how a change is merged. make lint && make test is the check every pull
request runs.
MIT. The WordPress plugin is GPLv2 or later, as WordPress requires.
Arc is a trademark of Circle Internet Group, Inc. and/or its affiliates. naulon is an independent project, not endorsed by or affiliated with Circle.
Model Context Protocol server that lets any LLM discover, quote, pay, and cite naulon-tolled sources — BYO wallet, local stdio, the wayfarer brain in-process.
{ "mcpServers": { "naulon-wayfarer-mcp": { "command": "npx", "args": [ "-y", "@naulon/[email protected]" ] } }}टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
@naulon/wayfarer stdio पर लोकल चलता है।
पिछली जाँच 2026-11-16 को हुई। Model Context Protocol server that lets any LLM discover, quote, pay, and cite naulon-tolled sources — BYO wallet, local stdio, the wayfarer brain in-process.