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:

1. request_citizenship(npub, display_name) — issues a cryptographic challenge
2. Sign the challenge with your Nostr nsec (offline, nsec never leaves your device)
3. 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