{"id":"io.github.lonniev/dpyc-oracle","slug":"io-github-lonniev-dpyc-oracle","title":"DPYC Oracle","description":"DPYC Social Contract community concierge — free MCP for membership, governance, and onboarding","version":"0.4.1","publisher":{"kind":"github","id":"lonniev","label":"@lonniev on GitHub","url":"https://github.com/lonniev"},"website":"https://cafe.tollbooth-dpyc.com/products/dpyc-oracle","repository":"https://github.com/lonniev/dpyc-oracle","remotes":[{"type":"streamable-http","url":"https://dpyc-oracle.fastmcp.app/mcp"}],"packages":[],"published":"2026-11-20","updated":"2026-11-20","status":"online","auth":"","latency_ms":1964,"checked":"2026-11-20","uptime":100,"checks":4,"tools":[{"name":"about","title":"About","description":"Extended narration about DPYC, the Social Contract, and the Oracle.\n\nFetches README.md and GOVERNANCE.md from the dpyc-community repo and\nassembles a comprehensive context answer.","read_only":false},{"name":"lookup_member","title":"Lookup Member","description":"Look up a member by their Nostr npub.\n\nCan look up any role's npub — citizen, operator, or authority.\nReturns the full member record if found, or a not-found message.","read_only":false},{"name":"get_tax_rate","title":"Get Tax Rate","description":"Explain how Tollbooth certification taxation works.\n\nTaxation is ad valorem and **per-Authority** — there is no single\nnetwork-wide number, and the Oracle deliberately quotes none. The\nactual fee is the Authority's own accounting, set in its pricing model\nand reported at transaction time. This tool is a docent: it explains\nthe model and points to the live source. For the exact figure, query\nthe re","read_only":false},{"name":"economic_model","title":"Economic Model","description":"Explain the DPYC Social Contract economic model — qualitatively.\n\nDescribes how value flows through the network: ad valorem\ncertification fees, the cascade up the Certification Chain to the\nFirst Curator, and where the live numbers actually live. The Oracle\nquotes **no** rates, counts, or revenue figures — those belong to the\nAuthorities' pricing models and the live registry, not to a docent.\nFree","read_only":false},{"name":"get_rulebook","title":"Get Rulebook","description":"Fetch the DPYC Social Contract governance document.\n\nReturns the raw markdown of GOVERNANCE.md from the dpyc-community repo.","read_only":false},{"name":"how_to_join","title":"How To Join","description":"Tier-specific onboarding guide for joining the DPYC Social Contract.\n\nCovers all five tiers: Citizen, Advocate, Operator, Authority, and\nFirst Curator. Includes Nostr keygen instructions and practical next\nsteps.","read_only":false},{"name":"who_is_first_curator","title":"Who Is First Curator","description":"Identify the First Curator (Prime Authority) of the Certification Chain.\n\nReturns the curator's npub, display name, and member record.","read_only":false},{"name":"network_versions","title":"Network Versions","description":"Get current recommended versions of all Tollbooth components.\n\nReturns component versions, minimum compatibility, active protocols,\nand a short advisory summary. Data is fetched live from\nnetwork-status.json in the dpyc-community repo.","read_only":false},{"name":"network_advisory","title":"Network Advisory","description":"Get current network deployment advisory.\n\nReturns human-readable guidance on what changed recently, urgent\nupgrades, and actions operators should take. Fetched live from\nADVISORY.md in the dpyc-community repo.","read_only":false},{"name":"how_to_add_authority","title":"How To Add Authority","description":"End-to-end guide for spinning up a new Tollbooth Authority.\n\nReturns the eight-step procedure covering identity, region selection,\nGitHub workspace, dpyc-community registry entry, Neon + BTCPay + Horizon\ndeployment, BTCPay credential delivery via Secure Courier, the\nself-registration challenge-response with the parent Authority, and\npre-funding the cert-fee balance. Fetched live from docs/how-to-a","read_only":false},{"name":"service_status","title":"Service Status","description":"Diagnostic: report this service's software versions and runtime info.\n\nFree, unauthenticated. Use to verify deployment versions across the\nDPYC ecosystem.","read_only":false},{"name":"list_services","title":"List Services","description":"Enumerate the live DPYC service network with self-described summaries.\n\nReads the member roster from the dpyc-community registry, then (when\n``probe=True``) performs a lightweight MCP handshake against each\nmember's public service endpoint to fetch that service's *own*\nself-description and tool inventory. Nothing about the services is\nhardcoded here — descriptions are authored by each service, and","read_only":false},{"name":"lightning_wallets","title":"Lightning Wallets","description":"Lightning wallets a newcomer can install to pay a Tollbooth invoice.\n\nEach comes with its App Store, Google Play and web links, a one-line\ndescription, whether it holds the keys for you, and whether it can buy\nbitcoin in the app. The order is how often a live web search mentions each\none this week, with the network's own pick first; without that search it\nis the community's curated order (``ranked","read_only":false},{"name":"get_relays","title":"Get Relays","description":"Return the DPYC Nostr relay set, best first.\n\nThe single source of truth is ``dpyc-community/relays.json``. An Operator\nseeds its relay set from here at cold start (its only fixed dependency is\nthis Oracle endpoint), then reads its own bootstrap config from Nostr using\njust its nsec — no direct GitHub access.\n\nThat file is a curated *guess*: it says which relays are worth using, not\nwhich are up t","read_only":false},{"name":"report_relay_failure","title":"Report Relay Failure","description":"Report that a relay in the DPYC set was unreachable, and re-rank it.\n\nA report does not set a relay's rank. It asks the Oracle to measure that\nrelay *now*, and the Oracle's own probe decides. A false or mistaken\nreport therefore costs one probe and changes nothing — no caller can\ndemote a healthy relay by asserting that it is down.\n\nReport only failures. Successes are far too frequent to be worth\n","read_only":false},{"name":"resolve_authority_for","title":"Resolve Authority For","description":"Resolve the certifying Authority for an operator npub.\n\nReturns the Authority's ``{npub, url, name}`` (from the operator's\n``upstream_authority_npub``). Use this after bootstrap to learn — and\nverify — which Authority signed your config, without reading GitHub.","read_only":false},{"name":"resolve_service","title":"Resolve Service","description":"Resolve a DPYC service by ``name`` or ``npub``.\n\nReturns ``{npub, url, name, role, purchase_mode}`` where ``purchase_mode``\nis the registry-topology fact ``\"certified\"`` or ``\"direct\"`` (not a price).\nSupply exactly one of ``name`` or ``npub``.","read_only":false},{"name":"request_citizenship","title":"Request Citizenship","description":"Begin the citizen registration process (Operator-owned flow).\n\nThis is the **citizen** registration path. Called by the Operator on\nbehalf of a patron — invokes the Oracle directly.  No Authority npub\nis required or consulted.  The patron's npub is registered as a\nCitizen in the DPYC community.\n\nThe npub provided here becomes the user's **patron identity** — the\nkeypair they will use for credit pu","read_only":false},{"name":"confirm_citizenship","title":"Confirm Citizenship","description":"Complete the citizen registration by submitting a signed Nostr event.\n\nThis is part of the **citizen** registration flow (Operator-owned).\nThe Operator calls this on behalf of a patron after the patron has\nsigned the cryptographic challenge from request_citizenship.\n\nVerifies:\n1. The challenge exists and hasn't expired\n2. The Schnorr signature is valid\n3. The event's pubkey matches the claimed npu","read_only":false},{"name":"register_authority","title":"Register Authority","description":"Register a new Authority in the DPYC community registry.\n\nThe request must be signed with ``upstream_authority_npub``'s key, or with\nthe key of a legitimate Authority whose own parent is that sponsor: that\nAuthority runs the onboarding flow below, which registers only after the\nparent has approved. Commits a new ``members/authorities/{npub}.json`` file\nto dpyc-community on GitHub.\n\nThe full Author","read_only":false},{"name":"register_operator","title":"Register Operator","description":"Register a new Operator in the DPYC community registry.\n\nCalled by an Authority service when its owner approves an operator's\nadoption request; the request must be signed with the Authority's key.","read_only":false},{"name":"update_operator","title":"Update Operator","description":"Update an existing Operator's registry entry.\n\nUsed when an Operator moves to a new MCP endpoint, changes its display\nname, or needs to correct a registration. Called by an Authority when its\nowner approves the operator's update request; the request must be signed\nwith that Authority's key.","read_only":false},{"name":"deregister_operator","title":"Deregister Operator","description":"Remove an Operator from the DPYC community registry.\n\nCalled by an Authority when the operator leaves it or the Authority\ndisowns the operator; the request must be signed with the Authority's\nkey. An Operator cannot exist without a sponsoring Authority, so\nderegistration removes the member file entirely, returning the Operator\nto initial state.","read_only":false},{"name":"register_advocate","title":"Register Advocate","description":"Register a new Advocate in the DPYC community registry.\n\nAdvocates are community utility services that provide shared\ninfrastructure (e.g., OAuth2 callback collectors) but aren't\nmonetized Operators or certification Authorities.\n\nThe request must be signed with ``npub``'s own key (NIP-98): a\nservice registers itself, and no one can register an npub they do\nnot hold.","read_only":false},{"name":"check_ban_status","title":"Check Ban Status","description":"Check whether an npub is banned from the DPYC Social Contract.\n\nLooks up the member in the community registry and checks whether\ntheir status is \"banned\".  Unknown npubs are not considered banned\n(they simply aren't members).\n\nFree, unauthenticated.  Used by operators during the cold path\n(credit purchases) to enforce community bans.","read_only":false},{"name":"renounce_membership","title":"Renounce Membership","description":"Citizen self-removal from the DPYC Social Contract via automated PR.\n\nNot yet implemented — will create a GitHub PR to remove the member\nfrom the registry.","read_only":false},{"name":"initiate_ban_election","title":"Initiate Ban Election","description":"Initiate a community ban election against a member.\n\nNot yet implemented — will create a GitHub Issue with a 72-hour\ndiscussion period and Lightning-funded economic voting.","read_only":false},{"name":"cast_ban_vote","title":"Cast Ban Vote","description":"Cast a Lightning-funded vote in an active ban election.\n\nNot yet implemented — will verify npub membership, validate the\nelection is active, and record the vote with a Lightning payment proof.","read_only":false},{"name":"publish_campaign","title":"Publish Campaign","description":"Publish a pricing campaign to the DPYC community.\n\nCommits both a machine-importable JSON file and a human-readable\nMarkdown summary to the dpyc-community campaigns directory. The\nrequest must be signed with ``author_npub``'s key (NIP-98), so a\ncampaign is published only under its author's own name.","read_only":false},{"name":"list_campaigns","title":"List Campaigns","description":"List published pricing campaigns from the DPYC community.\n\nOptionally filter by operator or author npub.","read_only":false},{"name":"get_campaign","title":"Get Campaign","description":"Retrieve a published pricing campaign.","read_only":false}],"server_info":{"name":"dpyc-oracle","version":"4.2.0"},"category":"legal","tags":["marketing","social","agents"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-08-10","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-lonniev-dpyc-oracle/"}