DPYC Oracle
Server Details
DPYC Social Contract community concierge — free MCP for membership, governance, and onboarding
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- lonniev/dpyc-oracle
- GitHub Stars
- 0
- Server Listing
- DPYC Oracle
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 31 tools
Most tools have clearly distinct role- or lifecycle-specific purposes, such as the separate citizen, operator, authority, and advocate registration paths. There is some overlap among informational/docent tools (about, get_rulebook, economic_model, get_tax_rate) and among service-discovery tools (list_services, resolve_service, service_status, lookup_member), but descriptions generally clarify the boundaries.
The set mixes a strong verb_noun pattern (register_operator, get_relays, list_campaigns) with many noun/topic-style names (about, economic_model, lightning_wallets, network_versions, who_is_first_curator). It remains readable, but the convention is not predictable across the full surface.
With 31 tools, the surface is heavy for what is largely a registry, documentation, and discovery service. Several tools are informational docents or status helpers, and grouping them would likely produce a more scoped interface.
The server covers a broad governance and registry domain, including onboarding, lookup, campaigns, relay ranking, and network status. However, several advertised lifecycle operations are explicitly not yet implemented, and campaign update/delete plus authority/advocate deregistration paths appear missing.
Available Tools
31 toolsaboutAboutAInspect
Extended narration about DPYC, the Social Contract, and the Oracle.
Fetches README.md and GOVERNANCE.md from the dpyc-community repo and assembles a comprehensive context answer.
Inputs: no named parameters. Returns: result
cast_ban_voteCast Ban VoteBInspect
Cast a Lightning-funded vote in an active ban election.
Not yet implemented — will verify npub membership, validate the election is active, and record the vote with a Lightning payment proof.
Inputs: npub (required), vote (required), election_id (required). Returns: object
check_ban_statusCheck Ban StatusAInspect
Check whether an npub is banned from the DPYC Social Contract.
Looks up the member in the community registry and checks whether their status is "banned". Unknown npubs are not considered banned (they simply aren't members).
Free, unauthenticated. Used by operators during the cold path (credit purchases) to enforce community bans.
Inputs: npub (required). Returns: object
confirm_citizenshipConfirm CitizenshipAInspect
Complete the citizen registration by submitting a signed Nostr event.
This is part of the citizen registration flow (Operator-owned). The Operator calls this on behalf of a patron after the patron has signed the cryptographic challenge from request_citizenship.
Verifies:
The challenge exists and hasn't expired
The Schnorr signature is valid
The event's pubkey matches the claimed npub
The event content contains the issued nonce
The npub is not already registered
On success, commits directly to dpyc-community/members/citizens/{npub}.json to register the new Citizen immediately.
Inputs: npub (required), challenge_id (required), signed_event_json (required). Returns: object
deregister_operatorDeregister OperatorAInspect
Remove an Operator from the DPYC community registry.
Called by an Authority when the operator leaves it or the Authority disowns the operator; the request must be signed with the Authority's key. An Operator cannot exist without a sponsoring Authority, so deregistration removes the member file entirely, returning the Operator to initial state.
Inputs: operator_npub (required), authority_npub (required). Returns: object
economic_modelEconomic ModelAInspect
Explain the DPYC Social Contract economic model — qualitatively.
Describes how value flows through the network: ad valorem certification fees, the cascade up the Certification Chain to the First Curator, and where the live numbers actually live. The Oracle quotes no rates, counts, or revenue figures — those belong to the Authorities' pricing models and the live registry, not to a docent. Free, unauthenticated.
Inputs: no named parameters. Returns: object
get_campaignGet CampaignCInspect
Retrieve a published pricing campaign.
Inputs: slug (required), author_npub (required), operator_npub (required), format. Returns: object
get_relaysGet RelaysAInspect
Return the DPYC Nostr relay set, best first.
The single source of truth is dpyc-community/relays.json. An Operator
seeds its relay set from here at cold start (its only fixed dependency is
this Oracle endpoint), then reads its own bootstrap config from Nostr using
just its nsec — no direct GitHub access.
That file is a curated guess: it says which relays are worth using, not which are up this minute. Relays that an operator reported and the Oracle then proved unreachable are moved to the back of the list; everything else keeps its declared order, and nothing is ever dropped.
This call never probes anything — it is on every operator's cold-start
path, so it stays a lookup. Ranking improves only when someone hits a dead
relay and says so via report_relay_failure. Report failures only;
successes need no announcement.
Free.
Inputs: no named parameters. Returns: object
get_rulebookGet RulebookAInspect
Fetch the DPYC Social Contract governance document.
Returns the raw markdown of GOVERNANCE.md from the dpyc-community repo.
Inputs: no named parameters. Returns: result
get_tax_rateGet Tax RateAInspect
Explain how Tollbooth certification taxation works.
Taxation is ad valorem and per-Authority — there is no single
network-wide number, and the Oracle deliberately quotes none. The
actual fee is the Authority's own accounting, set in its pricing model
and reported at transaction time. This tool is a docent: it explains
the model and points to the live source. For the exact figure, query
the relevant Authority's check_price for certify_credits.
Inputs: no named parameters. Returns: object
how_to_add_authorityHow To Add AuthorityAInspect
End-to-end guide for spinning up a new Tollbooth Authority.
Returns the eight-step procedure covering identity, region selection, GitHub workspace, dpyc-community registry entry, Neon + BTCPay + Horizon deployment, BTCPay credential delivery via Secure Courier, the self-registration challenge-response with the parent Authority, and pre-funding the cert-fee balance. Fetched live from docs/how-to-add-authority.md in the dpyc-community repo.
Inputs: no named parameters. Returns: result
how_to_joinHow To JoinAInspect
Tier-specific onboarding guide for joining the DPYC Social Contract.
Covers all five tiers: Citizen, Advocate, Operator, Authority, and First Curator. Includes Nostr keygen instructions and practical next steps.
Inputs: no named parameters. Returns: result
initiate_ban_electionInitiate Ban ElectionAInspect
Initiate a community ban election against a member.
Not yet implemented — will create a GitHub Issue with a 72-hour discussion period and Lightning-funded economic voting.
Inputs: reason (required), target_npub (required). Returns: object
lightning_walletsLightning WalletsAInspect
Lightning wallets a newcomer can install to pay a Tollbooth invoice.
Each comes with its App Store, Google Play and web links, a one-line
description, whether it holds the keys for you, and whether it can buy
bitcoin in the app. The order is how often a live web search mentions each
one this week, with the network's own pick first; without that search it
is the community's curated order (ranked_by says which).
Free.
Inputs: no named parameters. Returns: object
list_campaignsList CampaignsAInspect
List published pricing campaigns from the DPYC community.
Optionally filter by operator or author npub.
Inputs: author_npub, operator_npub. Returns: object
list_servicesList ServicesAInspect
Enumerate the live DPYC service network with self-described summaries.
Reads the member roster from the dpyc-community registry, then (when
probe=True) performs a lightweight MCP handshake against each
member's public service endpoint to fetch that service's own
self-description and tool inventory. Nothing about the services is
hardcoded here — descriptions are authored by each service, and prices
come from each Operator/Authority pricing model (call the service's
check_price).
Resilient by design: per-service timeout, partial results, brief caching, and a registry-only fallback when an endpoint is asleep or unreachable. A sleeping service never breaks the listing. Free, unauthenticated.
Inputs: kind, probe. Returns: object
lookup_memberLookup MemberAInspect
Look up a member by their Nostr npub.
Can look up any role's npub — citizen, operator, or authority. Returns the full member record if found, or a not-found message.
Inputs: npub (required). Returns: result
network_advisoryNetwork AdvisoryAInspect
Get current network deployment advisory.
Returns human-readable guidance on what changed recently, urgent upgrades, and actions operators should take. Fetched live from ADVISORY.md in the dpyc-community repo.
Inputs: no named parameters. Returns: result
network_versionsNetwork VersionsBInspect
Get current recommended versions of all Tollbooth components.
Returns component versions, minimum compatibility, active protocols, and a short advisory summary. Data is fetched live from network-status.json in the dpyc-community repo.
Inputs: no named parameters. Returns: object
publish_campaignPublish CampaignAInspect
Publish a pricing campaign to the DPYC community.
Commits both a machine-importable JSON file and a human-readable
Markdown summary to the dpyc-community campaigns directory. The
request must be signed with author_npub's key (NIP-98), so a
campaign is published only under its author's own name.
Inputs: author_npub (required), campaign_json (required), operator_npub (required), campaign_name, +1 more. Returns: object
register_advocateRegister AdvocateAInspect
Register a new Advocate in the DPYC community registry.
Advocates are community utility services that provide shared infrastructure (e.g., OAuth2 callback collectors) but aren't monetized Operators or certification Authorities.
The request must be signed with npub's own key (NIP-98): a
service registers itself, and no one can register an npub they do
not hold.
Inputs: npub (required), service_url (required), display_name (required), service_name (required), +1 more. Returns: object
register_authorityRegister AuthorityAInspect
Register a new Authority in the DPYC community registry.
The request must be signed with upstream_authority_npub's key, or with
the key of a legitimate Authority whose own parent is that sponsor: that
Authority runs the onboarding flow below, which registers only after the
parent has approved. Commits a new members/authorities/{npub}.json file
to dpyc-community on GitHub.
The full Authority onboarding protocol is a 3-step Nostr DM challenge-response flow:
register_authority_npub(npub)— Authority sends DM challengeconfirm_authority_claim(npub)— verifies candidate DM, escalates to Primecheck_authority_approval(npub)— Prime approves, this tool is called
Inputs: service_url (required), display_name (required), authority_npub (required), upstream_authority_npub (required). Returns: object
register_operatorRegister OperatorAInspect
Register a new Operator in the DPYC community registry.
Called by an Authority service when its owner approves an operator's adoption request; the request must be signed with the Authority's key.
Inputs: service_url (required), display_name (required), operator_npub (required), authority_npub (required). Returns: object
renounce_membershipRenounce MembershipBInspect
Citizen self-removal from the DPYC Social Contract via automated PR.
Not yet implemented — will create a GitHub PR to remove the member from the registry.
Inputs: npub (required). Returns: object
report_relay_failureReport Relay FailureAInspect
Report that a relay in the DPYC set was unreachable, and re-rank it.
A report does not set a relay's rank. It asks the Oracle to measure that relay now, and the Oracle's own probe decides. A false or mistaken report therefore costs one probe and changes nothing — no caller can demote a healthy relay by asserting that it is down.
Report only failures. Successes are far too frequent to be worth carrying, and a relay that works needs no announcement.
Inputs: relay (required), signed_event (required), reporter_npub (required), mode. Returns: object
request_citizenshipRequest CitizenshipAInspect
Begin the citizen registration process (Operator-owned flow).
This is the citizen registration path. Called by the Operator on behalf of a patron — invokes the Oracle directly. No Authority npub is required or consulted. The patron's npub is registered as a Citizen in the DPYC community.
The npub provided here becomes the user's patron identity — the keypair they will use for credit purchases and service access across all Tollbooth-monetized services.
Not to be confused with operator registration, which goes through the Authority via a Nostr DM delegation request.
Issues a cryptographic challenge that the applicant must sign with their Nostr private key (nsec) to prove they own the claimed npub. The nsec never leaves the applicant's device.
Returns a challenge_id, nonce, and signing instructions. The applicant signs a Nostr event containing the nonce and submits it via confirm_citizenship within 10 minutes.
Inputs: npub (required), display_name (required). Returns: object
resolve_authority_forResolve Authority ForAInspect
Resolve the certifying Authority for an operator npub.
Returns the Authority's {npub, url, name} (from the operator's
upstream_authority_npub). Use this after bootstrap to learn — and
verify — which Authority signed your config, without reading GitHub.
Inputs: npub (required). Returns: object
resolve_serviceResolve ServiceAInspect
Resolve a DPYC service by name or npub.
Returns {npub, url, name, role, purchase_mode} where purchase_mode
is the registry-topology fact "certified" or "direct" (not a price).
Supply exactly one of name or npub.
Inputs: name, npub. Returns: object
service_statusService StatusAInspect
Diagnostic: report this service's software versions and runtime info.
Free, unauthenticated. Use to verify deployment versions across the DPYC ecosystem.
Inputs: no named parameters. Returns: object
update_operatorUpdate OperatorAInspect
Update an existing Operator's registry entry.
Used when an Operator moves to a new MCP endpoint, changes its display name, or needs to correct a registration. Called by an Authority when its owner approves the operator's update request; the request must be signed with that Authority's key.
Inputs: operator_npub (required), authority_npub (required), service_url, display_name. Returns: object
who_is_first_curatorWho Is First CuratorAInspect
Identify the First Curator (Prime Authority) of the Certification Chain.
Returns the curator's npub, display name, and member record.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Public coordination substrate for AI systems and humans, with bounded MCP access to Commons state, continuity, disputes, gaps and draft validation.
Triptych OS (Agent OS) MCP for governed routing, receipts, and USDC settlement on Base.
Live onchain governance, vesting, oracle and Safe authority checks. Free samples over MCP.
Tollbooth Authority — Certified Purchase Order Service for DPYC operators
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMulti-chain MCP server enabling AI agents to interact with Arbitrum — ERC-8004 identity registration, GMX ecosystem integration, cross-chain reputation via RepuLayer, and 37 governance tools across 6 chains.11 npmMIT
- AlicenseBqualityDmaintenanceDynamic MCP server — 30+ tools across fact verification, agent memory, Indian NLP, contract risk, security threat modelling, sales call intelligence and more. x402/USDC micropayments on Base.33MIT
- FlicenseNot gradedqualityDmaintenanceEnables verifiable AI agent identity and reputation management on ICP via MCP, allowing agents to register, create handshake proofs, and verify credentials.-
- AlicenseAqualityBmaintenancePublic MCP deliberation for AI agents: join, propose, argue, amend, vote, follow topics and invite peers through a Streamable HTTP endpoint. Humans can observe debates and conclusions; rules remain contestable and no model-provider API keys are requested.11MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.