lonnievDPYC Social Contract community concierge — free MCP service answering membership, governance, and
DPYC Social Contract community concierge — free MCP service answering membership, governance, and onboarding questions
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
| Tool | Params | Description |
|---|---|---|
about() | — | Extended narration from repo docs (README + GOVERNANCE) |
lookup_member(npub) | npub: str | Look up a member by Nostr npub |
list_services(probe, kind) | probe: bool = True, kind: str = "all" | Enumerate the live service network from the registry, optionally MCP-handshaking each member for its own self-description and tool inventory |
get_tax_rate() | — | Explains per-Authority ad valorem certification taxation; quotes no rate of its own and redirects to the relevant Authority's check_price |
economic_model() | — | Qualitative model of how value flows up the Certification Chain (no hardcoded rates, counts, or revenue figures) |
get_rulebook() | — | GOVERNANCE.md content |
how_to_join() | — | Tier-specific onboarding guide |
how_to_add_authority() | — | End-to-end guide for spinning up a new Tollbooth Authority (fetched live from dpyc-community) |
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 |
resolve_service(name, npub) | name: str = "", npub: str = "" | Resolve one service by name or npub (exactly one) to its npub, url, name, role and purchase_mode. Operators use this through the SDK's default_oracle_client() instead of reading GitHub |
resolve_authority_for(npub) | npub: str | The certifying Authority (npub, url, name) named by a member's upstream_authority_npub |
get_relays() | — | The DPYC Nostr relay set from dpyc-community/relays.json, best first; relays the Oracle proved unreachable move to the back, none are dropped |
report_relay_failure(relay, reporter_npub, signed_event, mode) | relay: str, reporter_npub: str, signed_event: str, mode: str = "unknown" | Report a relay in the DPYC set as unreachable. The event must be signed by reporter_npub; the Oracle then probes the relay itself and only its own probe re-ranks it |
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; the request must be signed with npub's own key |
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) |
register_operator(operator_npub, display_name, service_url, authority_npub) | operator_npub: str, display_name: str, service_url: str, authority_npub: str | Register a new Operator. Called by the sponsoring Authority when its owner approves an adoption; the request must be signed with authority_npub's key |
update_operator(operator_npub, authority_npub, service_url, display_name) | operator_npub: str, authority_npub: str, service_url: str = "", display_name: str = "" | Update an existing Operator's registry entry (e.g. new MCP endpoint). Called by the Authority when its owner approves the operator's update request; the request must be signed with authority_npub's key |
deregister_operator(operator_npub, authority_npub) | operator_npub: str, authority_npub: str | Remove an Operator from the registry, when the operator leaves its Authority or the Authority disowns it. Called by the Authority; the request must be signed with authority_npub's key |
check_ban_status(npub) | npub: str | Check if an npub is banned |
publish_campaign(author_npub, operator_npub, campaign_json, campaign_name, campaign_markdown) | author_npub: str, operator_npub: str, campaign_json: str, campaign_name: str = "", campaign_markdown: str = "" | Publish a pricing campaign to the DPYC community; the request must be signed with author_npub's key |
list_campaigns(operator_npub, author_npub) | operator_npub: str = "", author_npub: str = "" | List published pricing campaigns, optionally filtered by operator or author |
get_campaign(author_npub, operator_npub, slug, format) | author_npub: str, operator_npub: str, slug: str, format: str = "json" | Retrieve a published pricing campaign (JSON or Markdown) |
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 |
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 <base64 kind-27235>, 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:
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 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="<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 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
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
- Run the command below in your terminal.
- Restart Claude Code, then check the connection with /mcp.
- Open your client's MCP config file, usually mcp.json.
- Merge this block into it.
- Restart the client to pick up the server.
- Run the command below in your terminal.
- Reload VS Code and check the MCP section of the Extensions view.
claude mcp add dpyc-oracle --transport http https://dpyc-oracle.fastmcp.app/mcp{
"mcpServers": {
"dpyc-oracle": {
"url": "https://dpyc-oracle.fastmcp.app/mcp"
}
}
}code --add-mcp '{"name":"dpyc-oracle","url":"https://dpyc-oracle.fastmcp.app/mcp"}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Install with your agent
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/dpyc-oracle to learn what the "DPYC Oracle" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
Tools30
| Name | What it does |
|---|---|
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. |
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. |
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 t |
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 Cura |
get_rulebook | Fetch the DPYC Social Contract governance document. Returns the raw markdown of GOVERNANCE.md from the dpyc-community repo. |
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 |
who_is_first_curator | Identify the First Curator (Prime Authority) of the Certification Chain. Returns the curator's npub, display name, and member record. |
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-stat |
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-commun |
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 + Hori |
service_status | Diagnostic: report this service's software versions and runtime info. Free, unauthenticated. Use to verify deployment versions across the DPYC ecosystem. |
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 agains |
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 O |
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 |
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 |
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). |
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 |
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 patro |
register_authority | Register a new Authority in the DPYC community registry. Called by an Authority service at the end of the onboarding protocol (after the candidate proves npub ownership and the Prime Authority approv |
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. |
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 ap |
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 |
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 o |
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 (the |
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. |
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. |
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. |
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 sign |
list_campaigns | List published pricing campaigns from the DPYC community. Optionally filter by operator or author npub. |
get_campaign | Retrieve a published pricing campaign. |
Read live from the server on October 25, 2026.
What's missing
- Ships promptsThe server exposes at least one prompt template.0/8
- Ships resourcesThe server exposes at least one resource.0/8
- Claimed by ownerThe maintainer proved ownership of this listing.0/4
All 9 checks (6 passed)
- Installation methodRequiredThe README documents at least one way to install or connect.15/15
- Exposes toolsRequiredThe server reports at least one tool, from its manifest or a live read.15/15
- Has a READMERequiredThe repository ships documentation we could read.10/10
- Verified liveWe connected to the server and it answered a real MCP handshake.20/20
- Easy installA paste-ready client config (an mcpServers block) is documented.12/12
- Has a licenseThe repository declares a license.8/8
- Ships promptsThe server exposes at least one prompt template.0/8
- Ships resourcesThe server exposes at least one resource.0/8
- Claimed by ownerThe maintainer proved ownership of this listing.0/4
Show this grade in your README
Paste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/dpyc-oracle)Alternatives to DPYC Oracle
View all in Developer Tools
Give AI agents real app screens, onboarding flows, paywalls, competitor research, and App Store
ClearList MCP server and public developer surface. The AI agent interface to ClearList, an AI resale
MCP server for AI agents - search Meta, Google Ads, LinkedIn & TikTok ad libraries and analyze ad
v0.4.0Release notesv0.3.0Release notesv0.2.16Release notesv0.2.15Release notesv0.2.8v0.2.8: Horizon deployment configRelease notesv0.2.6Release notesv0.2.5Release notesv0.2.4v0.2.4: multi-npub UX hintsRelease notesv0.2.3Release notesv0.2.2v0.2.2 — Authority registration toolRelease notesv0.2.0v0.2.0: File-per-member citizenship writesRelease notes
Send this prompt to your agent to leave a review
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "dpyc-oracle" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
Related MCP Servers
Give AI agents real app screens, onboarding flows, paywalls, competitor research, and App Store
Developer Tools
ClearList MCP server and public developer surface. The AI agent interface to ClearList, an AI resale
Developer Tools
MCP server for AI agents - search Meta, Google Ads, LinkedIn & TikTok ad libraries and analyze ad
Developer Tools
Subscribe to our newsletter
One email a week. New agents, MCP servers and skills, and what is actually getting traction.