DPYC Social Contract community concierge — free MCP for membership, governance, and onboarding
| Endpoint | https://dpyc-oracle.fastmcp.app/mcp (streamable-http) |
|---|---|
| Registry version | 0.4.0 |
| Now | 31 tools · grade C (68) · pin ts_66f61a604ee416020cfe2231c36538ce · protocol 2025-06-18 |
| First / last listed | 2026-11-07 01:09 UTC / 2026-11-07 01:09 UTC |
| Grade over time | 2026-11-07: C (68), 31 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: about lookup_member get_tax_rate economic_model get_rulebook how_to_join who_is_first_curator network_versions network_advisory how_to_add_authority service_status list_services lightning_wallets get_relays report_relay_failure resolve_authority_for resolve_service request_citizenship confirm_citizenship register_authority register_operator update_operator deregister_operator register_advocate check_ban_status renounce_membership initiate_ban_election cast_ban_vote publish_campaign list_campaigns get_campaign
about | 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. params: none |
lookup_member | 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. params: npub* |
get_tax_rate | 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 re params: none |
economic_model | 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 params: none |
get_rulebook | Fetch the DPYC Social Contract governance document.
Returns the raw markdown of GOVERNANCE.md from the dpyc-community repo. params: none |
how_to_join | 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. params: none |
who_is_first_curator | Identify the First Curator (Prime Authority) of the Certification Chain.
Returns the curator's npub, display name, and member record. params: none |
network_versions | 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. params: none |
network_advisory | 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. params: none |
how_to_add_authority | 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-a params: none |
service_status | Diagnostic: report this service's software versions and runtime info.
Free, unauthenticated. Use to verify deployment versions across the
DPYC ecosystem. params: none |
list_services | 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 params: probe, kind |
lightning_wallets | 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 params: none |
get_relays | 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 t params: none |
report_relay_failure | 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
params: relay*, reporter_npub*, signed_event*, mode |
resolve_authority_for | 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. params: npub* |
resolve_service | 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``. params: name, npub |
request_citizenship | 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 pu params: npub*, display_name* |
confirm_citizenship | 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:
1. The challenge exists and hasn't expired
2. The Schnorr signature is valid
3. The event's pubkey matches the claimed npu params: npub*, challenge_id*, signed_event_json* |
register_authority | 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 Author params: authority_npub*, display_name*, service_url*, upstream_authority_npub* |
register_operator | 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. params: operator_npub*, display_name*, service_url*, authority_npub* |
update_operator | 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. params: operator_npub*, authority_npub*, service_url, display_name |
deregister_operator | 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. params: operator_npub*, authority_npub* |
register_advocate | 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. params: npub*, display_name*, service_name*, service_url*, service_description* |
check_ban_status | 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. params: npub* |
renounce_membership | 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. params: npub* |
initiate_ban_election | 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. params: target_npub*, reason* |
cast_ban_vote | 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. params: election_id*, vote*, npub* |
publish_campaign | 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. params: author_npub*, operator_npub*, campaign_json*, campaign_name, campaign_markdown |
list_campaigns | List published pricing campaigns from the DPYC community.
Optionally filter by operator or author npub. params: operator_npub, author_npub |
get_campaign | Retrieve a published pricing campaign. params: author_npub*, operator_npub*, slug*, format |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.