DPYC Oracle
A free, unauthenticated MCP concierge service for the DPYC Social Contract. The Oracle answers questions about membership, governance, onboarding, and tax rates by reading the dpyc-community GitHub registry live. No credits, no Neon database, no Secure Courier, no payment or credentials required.
Available Tools
| Tool | Params | Description |
|---|---|---|
about() |
— | Extended narration from repo docs (README + GOVERNANCE) |
lookup_member(npub) |
npub: str |
Look up a member by Nostr npub |
get_tax_rate() |
— | Current Tollbooth tax rate (2%) |
get_rulebook() |
— | GOVERNANCE.md content |
how_to_join() |
— | Tier-specific onboarding guide |
who_is_first_curator() |
— | First Curator's npub and record |
network_versions() |
— | Current recommended component versions |
network_advisory() |
— | Deployment advisory for operators |
service_status() |
— | Runtime version diagnostics |
request_citizenship(npub, display_name) |
npub: str, display_name: str |
Begin citizenship onboarding (issues challenge) |
confirm_citizenship(npub, challenge_id, signed_event_json) |
npub: str, challenge_id: str, signed_event_json: str |
Complete onboarding with signed Nostr event |
register_advocate(npub, display_name, service_name, service_url, service_description) |
npub: str, display_name: str, service_name: str, service_url: str, service_description: str |
Register a community utility service as an Advocate |
register_authority(authority_npub, display_name, service_url, upstream_authority_npub) |
authority_npub: str, display_name: str, service_url: str, upstream_authority_npub: str |
Register a new Authority (called by onboarding flow) |
check_ban_status(npub) |
npub: str |
Check if an npub is banned |
economic_model() |
— | Fee schedule and economic model details |
Stubbed (Future)
| Tool | Description |
|---|---|
renounce_membership(npub) |
Citizen self-removal via automated PR |
initiate_ban_election(target_npub, reason) |
Start economic ban voting |
cast_ban_vote(election_id, vote, npub) |
Lightning-funded ban vote |
Citizenship Onboarding
New citizens can self-register via Schnorr signature verification:
request_citizenship(npub, display_name)— issues a cryptographic challenge- Sign the challenge with your Nostr nsec (offline, nsec never leaves your device)
confirm_citizenship(npub, challenge_id, signed_event_json)— verifies signature and auto-commits
On success, the Oracle creates an individual member file at members/citizens/{npub}.json in dpyc-community. The CI workflow auto-regenerates members.json from individual files.
Advocate Registration
Advocates are community utility services (e.g., OAuth2 collectors) that provide shared infrastructure but aren't monetized Operators. Registration is Oracle-mediated — no challenge-response needed:
register_advocate(
npub="<service_npub>",
display_name="My Service",
service_name="my-service",
service_url="https://my-service.fastmcp.app",
service_description="What the service does",
)
The Oracle commits members/advocates/{npub}.json directly. Peer MCP servers discover the service URL via resolve_service_by_name() in the tollbooth-dpyc registry client.
How to Connect
This service is hosted on FastMCP Cloud. Add it to your MCP client configuration:
{
"mcpServers": {
"dpyc-oracle": {
"url": "https://www.fastmcp.com/server/lonniev/dpyc-oracle"
}
}
}
Related Repos
The authoritative, always-current roster lives in the registry — call lookup_member() / network_versions() for live data. The stable source repos:
Core
- dpyc-community — Registry, governance, and membership data
- tollbooth-dpyc — Python SDK every Operator and Authority builds on
- tollbooth-sample — Reference Operator template for new services
- tollbooth-pricing-studio — iOS app Operators use to design pricing models
Authorities (certification chain)
- tollbooth-authority — Certification + fee ledger
- tollbooth-authority-northamerica — Regional certifier
- tollbooth-authority-newengland — Sub-regional certifier
Operators
- thebrain-mcp — Personal Brain knowledge graph
- excalibur-mcp — X/Twitter posting
- schwab-mcp — Charles Schwab brokerage data
- taxsort-mcp — Tax sorting + classification
- optionality-mcp — Options analytics
- cypher-mcp — Monetized graph answers (named Cypher over Neo4j/AuraDB)
Advocates (shared utilities, unmonetized)
- tollbooth-oauth2-collector — OAuth2 authorization-code collection
- tollbooth-shortlinks — Ephemeral short URLs for OAuth flows
License
Apache-2.0
