About tollbooth-authority-northamerica
tollbooth-authority-northamerica is a regional certifier for DPYC operators in North America, operating under the DPYC Prime Authority. It shares the common Authority implementation and has a New England sub-authority.
Key features
- 01Regional operator certification
- 02DPYC Prime as its parent Authority
- 03New England sub-authority support
- 04Shared tollbooth-dpyc Authority tools
- 05Neon tenant in the Oregon region
Use cases
- 01Certifying operators serving North America
- 02Using a regional Authority for certification
- 03Maintaining certification records in the regional Neon tenant
MCP support
Exposes the shared Tollbooth Authority tools to MCP clients through a FastMCP server. The server uses the common tollbooth-dpyc Authority extension.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://tollbooth-authority-northamerica.fastmcp.app/mcpclaude mcp add --transport http lonniev-tollbooth-authority-northamerica https://tollbooth-authority-northamerica.fastmcp.app/mcp{"mcpServers":{"lonniev-tollbooth-authority-northamerica":{"type":"http","url":"https://tollbooth-authority-northamerica.fastmcp.app/mcp"}}}Open in Cursor{"servers":{"lonniev-tollbooth-authority-northamerica":{"type":"http","url":"https://tollbooth-authority-northamerica.fastmcp.app/mcp"}}}Open in VS Code{"mcpServers":{"lonniev-tollbooth-authority-northamerica":{"type":"http","url":"https://tollbooth-authority-northamerica.fastmcp.app/mcp"}}}{"mcpServers":{"lonniev-tollbooth-authority-northamerica":{"serverUrl":"https://tollbooth-authority-northamerica.fastmcp.app/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
70| Parameter | Type | Required | Description |
|---|---|---|---|
| npub | string | Yes | The Nostr public key (npub1...) whose balance to check. |
| dpop_token | string | Yes | Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name. |
Details
From the project READMETollbooth Authority — North America
The North American on-ramp to the Lightning turnpike.
Identity:
npub1zummm5awn88kw2hz6deeyjprpw0fzuv9rvzrxf3vu453yyqzvdss49xd2tParent: DPYC Prime Authority (npub1l94pd…mq8pf) Peer Authorities under Prime:tollbooth-authority(Lonnie-Authority) Sub-Authority:tollbooth-authority-newenglandService:https://tollbooth-authority-northamerica.fastmcp.app/mcpNeon region:aws-us-west-2(Oregon)
A peer-level Authority under DPYC Prime, serving North American operators. Operators may choose this Authority to keep certification latency and audit trails in-region.
The metaphors in this project are drawn with admiration from The Phantom Tollbooth by Norton Juster, illustrated by Jules Feiffer (1961). We just built the payment infrastructure.
Architecture
This repository is a thin consumer of the tollbooth-dpyc wheel's tollbooth.authority extension (wheel ≥ 0.22.1). The entire deployable surface lives in src/tollbooth_authority/server.py (~90 lines): a FastMCP instance, an OperatorRuntime, and two register_*_tools(mcp, runtime) calls. Onboarding state machine, Schnorr signer, replay tracker, Neon tenant provisioning, and the 16 Authority @tool definitions are wheel-resident and shared with every other Authority MCP in the ecosystem.
For the protocol semantics, certificate format (Schnorr/NIP-33 kind 30079), fee cascade, registry enforcement, and tool catalog, see the canonical tollbooth-authority README — this repo is identical in behavior, distinct only in identity, region, and Neon tenant.
Deploy
Two secrets required by Horizon:
| Env var | Value |
|---|---|
TOLLBOOTH_NOSTR_OPERATOR_NSEC | This Authority's nsec |
NEON_DATABASE_URL | A pooled Neon connection string in aws-us-west-2 |
Everything else — BTCPay credentials for the cashier, operator credential templates — arrives via Secure Courier post-deploy (see docs/how-to-add-authority.md in the community repo).
The DPYC Ecosystem
DPYC is a federation of independent, SSE-based MCP servers sharing one Lightning-funded economy. This Authority certifies operators across the network. Sibling repos:
Core & governance
tollbooth-dpyc— shared Python SDK (crypto, vault, auth, pricing, audit)dpyc-community— governance registry (members, rulebook, CI validation)dpyc-oracle— free community concierge (membership, onboarding, tax-rate questions)tollbooth-authority— canonical certification Authoritytollbooth-sample— reference Operator implementationtollbooth-pricing-studio— native pricing editor (Swift/iOS)
Operators (paid MCP services)
cypher-mcp— monetized graph answers via named Cypher templates over Neo4j/AuraDB (certified under this Authority)schwab-mcp— Charles Schwab brokerage datathebrain-mcp— TheBrain knowledge-graph accessexcalibur-mcp— X/Twitter postingtaxsort-mcp— tax classification + Cloudflare Pages UIoptionality-mcp— options analytics
Utilities & advocates
tollbooth-oauth2-collector— shared OAuth2 callback collectortollbooth-shortlinks— URL shortener
License
Apache-2.0
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.