# Cypher

> Monetized graph answers: named Cypher queries over the intention graph that remembers why each part of the Tollbooth DPYC network exists.

Cypher is a web app at https://cypher.tollbooth-dpyc.com and an MCP server that AI assistants can call.
It sells answers from a graph: operator-authored, parameterized, named Cypher queries.
A patron supplies the parameters, and the operator owns the query.
There is no raw database access.

The graph it serves is the intention graph of the DPYC Agentic Software Factory.
It records why each capability of the Tollbooth DPYC network exists, which service realizes it, and where the patent describes it.
Agents do not remember between sessions, so the graph is where what one agent learned waits for the next.

## Connecting an agent

The web app is one client of an MCP server, and an agent can call the same tools directly.

- MCP endpoint (streamable HTTP, no account, no API key): https://cypher-mcp.fastmcp.app/mcp
- Claude.ai or Claude Desktop: Customize → Connectors → Add custom connector → paste the endpoint; leave the OAuth fields blank
- Claude Code: `claude mcp add --transport http cypher https://cypher-mcp.fastmcp.app/mcp`
- Cursor (`.cursor/mcp.json`): `{"mcpServers": {"cypher": {"url": "https://cypher-mcp.fastmcp.app/mcp"}}}`
- VS Code (`.vscode/mcp.json`): `{"servers": {"cypher": {"type": "http", "url": "https://cypher-mcp.fastmcp.app/mcp"}}}`
- MCP Registry: `io.github.lonniev/cypher-mcp`

First connection:

1. Ask the person for their Nostr npub (npub1…). Never ask for an nsec.
2. `cypher_request_npub_proof(patron_npub=…)` sends them a Nostr direct message. They reply from their Nostr client; then call `cypher_receive_npub_proof(patron_npub=…, nonce=…)` once with the nonce the request returned. Your connection then holds the npub: pass only `npub` on every paid call.
3. `cypher_check_balance`. If it is empty, `cypher_purchase_credits` returns a Lightning invoice for the person to pay, and `cypher_check_payment` confirms it.

`cypher_service_status` and the `cypher_oracle_*` tools need no proof. `cypher_check_price` previews a fare. The server's own MCP `instructions` repeat these steps.

## What is on this site

- **Home** — the factory in one page, with live figures from the intention graph.
- **Factory** (`/factory`) — the crew of judgement and policy roles, how an issue and a PR move through it, and its two funding rails.
- **Memory** (`/memory`) — what the intention graph stores, and why.
- **Join** (`/join`) — bring a Nostr npub, prove you control it, and use the operator.
- **Lab Notebook** (`/notebook`) — signed-in views of capabilities, issues, recent activity and your wallet.

## Tools

- `cypher_execute_query_by_key(key, params)` runs a published query; `cypher_list_queries` and `cypher_get_query` show the catalog.
- Some queries are published as named tools of their own:
  - `cypher_which_service_handles(keyword)` — which service on the network handles a concern.
  - `cypher_explain_capability(name)` — why a capability exists, in the words of the person who authorized it.
  - `cypher_capability_patents(name)` — where the patent describes a capability.
  - `cypher_list_capabilities`, `cypher_recent_activity` and `cypher_public_factory_stats`.
- Each capability carries a provenance label: `human-authored` is doctrine, and `llm-inferred-unverified` is an agent's advice.

## Payments and identity

- Identity is a Nostr keypair (npub). There is no account, no email, no subscription and no KYC.
- A connection proves its npub with a Nostr DM challenge, or by signing each request with the npub's key (NIP-98).
- Tool calls debit a balance of sats, pre-funded with a Bitcoin Lightning invoice.
- Each operator sets its own per-tool prices. Monetization is the Tollbooth DPYC™ protocol: https://tollbooth-dpyc.com

## License, patent, and trademarks

- Source is open under the Apache License 2.0. The services built on it are private commerce: each operator sets its own tolls.
- Patent Pending — US Provisional Application 64/045,999 (Tollbooth DPYC Economic Architecture).
- DPYC™, Tollbooth DPYC™ and Don't Pester Your Customer™ are trademarks of Lonnie VanZandt.

## Links

- Web app: https://cypher.tollbooth-dpyc.com
- MCP endpoint: https://cypher-mcp.fastmcp.app/mcp
- Source: https://github.com/lonniev/cypher-mcp
- Every service on the network: https://mcps.tollbooth-dpyc.com
- Tollbooth DPYC™ (monetization SDK and network): https://tollbooth-dpyc.com
- DPYC community and patent filings: https://github.com/lonniev/dpyc-community
- DPYC Oracle (free community concierge): https://dpyc-oracle.fastmcp.app/mcp