MCP 服务器

DPYC Oracle

Enables querying and managing DPYC community membership, governance, and onboarding via a live GitHub registry, with tools for member lookup, citizenship registration, advocate registration, and rulebook access.

README

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