Dpyc Oracle

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. Registry writes are the exception: each must come on a signed request (see Signed registry writes).

Available Tools

Stubbed (Future)

Signed registry writes

register_operator, update_operator and deregister_operator change who the network trusts, so the Oracle takes them only from the Authority that sponsors the operator. The request must carry a NIP-98 signature (Authorization: Nostr , bound to the request's method, URL and body) made with the key of the authority_npub it names. An unsigned request, or one signed by any other key, is refused.

register_advocate and publish_campaign take the same NIP-98 signature, made with the key of the npub they write: an Advocate registers itself, and a campaign is published under its author's own npub. Anyone holding a key may do either; no one may do it in another npub's name.

Every other Oracle tool answers with no Authorization header at all.

Operators never call these tools themselves. An operator asks its Authority (request_adoption, update_operator or deregister_operator on the Authority), and the Authority makes the signed call here once its owner approves, or at once for a deregistration.

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 regenerates members/read-only-lookup-cache.json from the 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=" ", 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 and updates members/read-only-lookup-cache.json, so the Advocate is discoverable at once. Peer MCP servers discover the service URL through this Oracle's resolve_service(name=...), which tollbooth-dpyc calls as default_oracle_client().resolve_service(name=...).

How to Connect

This service is hosted on Horizon. Add it to your MCP client configuration:

{

"mcpServers": { "dpyc-oracle": { "url": "https://dpyc-oracle.fastmcp.app/mcp" } } }

Related Repos

The authoritative, always-current roster lives in the registry — call list_services() / 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
• tollbooth-web — Shared browser SDK for Operator front ends

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)
• goodearth-mcp — Region-scoped farm climate analytics
• beesknees-mcp — The Bee's Knees, a multiplayer race to the queen
• roastify-mcp — Roastify coffee catalog and packaging artwork
• ChartRemotely-mcp — Puts a security on a desktop chart through a paired agent

Advocates (shared utilities, unmonetized)

• tollbooth-oauth2-collector — OAuth2 authorization-code collection
• tollbooth-shortlinks — Ephemeral short URLs for OAuth flows

License

Apache-2.0