MCP serverio.github.lonniev/personalbrain-mcp
FastMCP server for TheBrain API — AI access to a personal knowledge graph, Tollbooth-monetized
Overview
Score?
UNRATED 0.672
of what a free look can see, on 30 looks
Looks
35
last 15 hr ago
Tools
83
changed 4 days ago
More info
URL
personal-brain.fastmcp.app/mcp
streamable-http
Says it is
thebrain-mcp 3.4.7
protocol 2025-06-18
In the record since
32 days ago
Among servers18,413 with a card
0median 0.606 · this server 0.672 · highest on record 0.8561
Toolsfrom sha256:136bff3cbb…07d59c · +0 −0 4 days ago
| Tool | Schema |
|---|---|
| brain_account_statement Generate a patron's account statement at this operator.
Returns the patron's purchase history, active credit tranches,
per-tool usage breakdown, and recent daily usage logs. This |
input · output |
| brain_account_statement_infographic Generate a visual SVG infographic of your account statement.
Returns the same data as account_statement, rendered as a dark-themed
SVG graphic with balance hero, metrics cards, he |
input · output |
| brain_add_file_attachment Add a file attachment to a thought. Requires npub for credit billing. |
input · output |
| brain_add_url_attachment Add a URL attachment to a thought. Requires npub for credit billing. |
input · output |
| brain_adoption_status Check this operator's adoption-request status at a chosen Authority.
Free. Polls the Authority MCP-to-MCP for the status of this operator's
request (pending / approved / rejected |
input · output |
| brain_append_to_note Append content to an existing note. Requires npub for credit billing.
Note style. Prefer plain prose. Reserve bold for rare critical flags only — a ⚠️ caution, an unconfirmed-stat |
input · output |
| brain_brain_query Primary tool for pattern-based operations on TheBrain. Requires npub for credit billing.
Accepts BrainQuery (BQL) -- a Cypher subset supporting MATCH, WHERE, CREATE,
SET, MERGE, D |
input · output |
| brain_check_authority_balance Check this operator's tax balance at the Authority.
Returns the sats available for certifying patron credit purchases.
When this balance reaches zero, patron top-ups cannot be cer |
input · output |
| brain_check_balance Check a patron's credit balance at this operator.
This is the patron's spending balance — credits purchased via
Lightning for tool calls at this operator. For the operator's
own b |
input · output |
| brain_check_payment Check the payment status of a Lightning invoice.
Call after paying the invoice from purchase_credits.
Free — no credits required. Proof of npub ownership is required
to prevent cr |
input · output |
| brain_check_price Preview the effective cost of a tool call.
Shows the base cost and any constraint effects (discounts, free
trials, surge pricing). Free — no credits required. |
input · output |
| brain_check_proof_status Check whether a proof grant is still valid.
Mirrors ``check_oauth_status`` for the npub-proof flow: a calling
agent can ask "will my next paid call accept this dpop_token?"
before |
input · output |
| brain_create_link Create a relationship between two thoughts by ID. Requires npub for credit billing. |
input · output |
| brain_create_or_update_note Create or update a note with markdown content. Requires npub for credit billing.
Note style. Prefer plain prose. Reserve bold for rare critical flags only — a ⚠️ caution, an uncon |
input · output |
| brain_create_thought Create a new thought with optional type, color, label, and parent link. Requires npub for credit billing. |
input · output |
| brain_delete_attachment Delete an attachment. Requires npub for credit billing. |
input · output |
| brain_delete_coupon Delete a coupon. Cascades to all patron redemptions.
Any chain step referencing the deleted coupon_id becomes a
no-op (the constraint returns neutral on unknown ids) — the
Studio |
input · output |
| brain_delete_link Permanently delete a link by ID. Cannot be undone. Requires npub for credit billing. |
input · output |
| brain_delete_operator_credential Remove a single operator secret field.
Deletes one key from the operator's encrypted credential blob without
touching the others — the field-level counterpart to
``forget_credenti |
input · output |
| brain_delete_patron_credential Remove a single patron credential field.
Deletes one field from stored credentials without affecting
other fields. Free. Proof of npub ownership is required —
this is a write to t |
input · output |
| brain_delete_thought Permanently delete a thought by ID. Cannot be undone. Requires npub for credit billing. |
input · output |
| brain_event_for_person Create an Event+Person+Day in one action. Requires npub for credit billing. |
input · output |
| brain_forget_coupon Remove a coupon from this patron's redemption list.
Cosmetic only — the coupon itself still exists at the operator,
and the patron can re-redeem the same code later while the
wind |
input · output |
| brain_forget_credentials Delete vaulted credentials for a specific service and npub.
For operator credentials, pass the operator's own npub. For patron
credentials, pass the patron's npub. Always requires |
input · output |
| brain_get_attachment Get metadata about an attachment. Requires npub for credit billing. |
input · output |
| brain_get_attachment_content Get the binary content of an attachment. Requires npub for credit billing. |
input · output |
| brain_get_brain Get details about a specific brain. Requires npub for credit billing. |
input · output |
| brain_get_brain_stats Get statistics about a brain. Requires npub for credit billing. |
input · output |
| brain_get_link Get details about a specific link. Requires npub for credit billing. |
input · output |
| brain_get_modifications The brain's authoritative, uncached change-log. Requires npub for credit billing.
Unlike get_thought_graph and search (Azure-cached, stale for recent writes),
this feed reflects e |
input · output |
| brain_get_nostr_profile Read an npub's public Nostr profile (NIP-01 kind-0 metadata).
Free, no proof — the data is already public on relays. Returns the
latest metadata fields (name, display_name, about, |
input · output |
| brain_get_notarization_proof Generate a Merkle inclusion proof that a patron's balance was
included in a Bitcoin-notarized snapshot. |
input · output |
| brain_get_note Get the note content for a thought. Requires npub for credit billing. |
input · output |
| brain_get_operator_onboarding_status Report this operator's configuration readiness.
Shows which operator settings are configured, which are missing,
and how to deliver each missing value. For patron-level credential |
input · output |
| brain_get_patron_credential_fields List stored patron credential field names (not values).
Returns the names of fields stored for a patron, plus each
field's ``delivered_at`` ISO-8601 timestamp when known (null
for |
input · output |
| brain_get_patron_onboarding_status Report a patron's credential readiness for this operator.
For set-once services (eXcalibur, TheBrain), shows which patron
secrets are configured and which are missing. For dynamic |
input · output |
| brain_get_pricing_model Get the active pricing model for this operator. Free.
If no model exists, self-initializes a scaffold with all
registered tools at 0 sats. No economic data from code. |
input · output |
| brain_get_tags Get all tags in a brain. Requires npub for credit billing. |
input · output |
| brain_get_thought Get details about a specific thought. Requires npub for credit billing. |
input · output |
| brain_get_thought_by_name Exact name lookup — returns the first thought matching the name exactly. Requires npub for credit billing.
⚠️ NOT AUTHORITATIVE. Backed by the vendor's name index, which is known |
input · output |
| brain_get_thought_graph Get a thought's full connection graph. Requires npub for credit billing.
⚠️ NOT AUTHORITATIVE FOR RECENT CHANGES. Served through the vendor's cached graph
layer (Azure App Service |
input · output |
| brain_get_thought_graph_paginated Cursor-based paginated traversal of a thought's connections. Requires npub for credit billing.
⚠️ NOT AUTHORITATIVE FOR RECENT CHANGES. Same cached graph layer as get_thought_grap |
input · output |
| brain_get_types List all thought types defined in the brain. Requires npub for credit billing. |
input · output |
| brain_list_attachments List all attachments for a thought. Requires npub for credit billing. |
input · output |
| brain_list_brains List available brains. |
input · output |
| brain_list_canonical_identities Return canonical (tool_id, mcp_name, …) for every tool the wheel exposes.
The authoritative source for any client (Studio, agents, FE)
that needs to know how this MCP identifies i |
input · output |
| brain_list_constraint_types List all available constraint types and their parameter schemas.
Returns the type, category, description, and parameter specs for
every constraint that can be used in a pricing pi |
input · output |
| brain_list_coupons List every coupon this operator has minted (newest first).
Each row carries the current ``times_redeemed`` counter — the
Studio renders a progress bar from this against ``total_us |
input · output |
| brain_list_my_coupons List the coupons this patron has redeemed on this operator.
Returns both active and exhausted redemptions with a per-row
``status`` (``active`` / ``window_closed`` / ``patron_limi |
input · output |
| brain_list_notarizations List recent Bitcoin notarization records. |
input · output |
| brain_mint_coupon Create a new operator-owned discount coupon. |
input · output |
| brain_morph_thought Atomically reparent and/or retype a thought in one operation. Requires npub for credit billing.
Reparenting *replaces* the thought's existing parent link (the old parent child-lin |
input · output |
| brain_notarize_ledger Build a Merkle tree of all patron balances and submit the root
to Bitcoin via OpenTimestamps.
Operator-only background task. Bitcoin confirmation takes 1-6 hours.
Free — no credit |
input · output |
| brain_oracle_about Describe the DPYC ecosystem via the Oracle. Free. |
input · output |
| brain_oracle_get_tax_rate Get the current DPYC certification tax rate. Free. |
input · output |
| brain_oracle_how_to_join Get DPYC onboarding instructions from the Oracle. Free. |
input · output |
| brain_oracle_lookup_member Look up a DPYC community member by npub. Free. |
input · output |
| brain_oracle_network_advisory Get active network advisories from the Oracle. Free. |
input · output |
| brain_publish_nostr_profile Publish a CLIENT-SIGNED kind-0 profile to relays for an npub.
The wheel never holds a patron nsec. The frontend signs the kind-0
metadata event with the patron's session key or a |
input · output |
| brain_purchase_credits Buy credits via Bitcoin Lightning.
Creates a Lightning invoice. Pay it with any Lightning wallet,
then call check_payment to confirm. Proof of npub ownership is
required so credit |
input · output |
| brain_receive_credentials Pick up credentials from the Secure Courier.
Completes the CREDENTIAL-DELIVERY flow (the ownership-proof
counterpart is ``receive_npub_proof``).
**Call this only after the user c |
input · output |
| brain_receive_npub_proof Receive npub ownership confirmation from a patron.
Completes the npub-OWNERSHIP-PROOF flow (the credential-delivery
counterpart is ``receive_credentials``).
**Call this only afte |
input · output |
| brain_receive_patron_credentials Pick up patron credentials from the Secure Courier.
Deterministic, one-shot retrieval: name the response with
``(sender_npub, dpop_token)`` and the tool drains ONLY the pinned
ren |
input · output |
| brain_redeem_coupon Claim a coupon by its name (the code the operator shared).
Looks up the operator's coupon by ``code``, validates the window
and total cap, and records a per-patron redemption row. |
input · output |
| brain_report_issue File a field report about this service as a GitHub issue on the operator's repo.
Found a tool's metadata or response wrong or confusing? Report it where the tool
lives. The **auth |
input · output |
| brain_request_adoption Ask a chosen Authority to adopt this operator (deferred courtship).
RESTRICTED to the operator — requires proof the caller controls this
operator's npub. Resolves the Authority's |
input · output |
| brain_request_credential_channel Open a Secure Courier channel for credential delivery.
This is the CREDENTIAL-DELIVERY flow — use it to hand over a service
secret (API keys, tokens). To merely prove you control |
input · output |
| brain_request_npub_proof Request npub ownership proof from a patron via Nostr DM.
This is the npub-OWNERSHIP-PROOF flow — use it when a call returns
``proof_required``. It proves the caller controls an np |
input · output |
| brain_request_patron_credentials Open a Secure Courier channel for patron credential delivery.
Sends a welcome DM with a credential template to the patron.
Free. |
input · output |
| brain_reset_pricing_model Erase all pricing models and restore a viable default.
Deletes every stored model, then self-initializes a fresh one
from the tool registry — all tools at 0 sats with proper UUIDs |
input · output |
| brain_restore_credits Credit a patron's ledger from a BTCPay-settled invoice.
**RESTRICTED to the operator** — the operator owns the books and is
the only party who can issue a manual credit grant. Pat |
input · output |
| brain_restore_neon_schema Prepare this operator's database schema again, ignoring the breadcrumb.
Diagnostic / recovery tool for when Neon keeps answering 4xx and the
operator suspects a table or grant is |
input · output |
| brain_scan_orphans Scan for orphaned thoughts with zero connections and optionally rescue them. Requires npub for credit billing. |
input · output |
| brain_search_thoughts Full-text search across thought names and content. Requires npub for credit billing.
⚠️ NOT AUTHORITATIVE. Backed by the vendor's search index, which is incomplete on
large brains |
input · output |
| brain_service_status Check the health and configuration of this service. Free. |
input · output |
| brain_session_status Check operator readiness. Returns the operator lifecycle
state and clear guidance on what to do next. Free.
Lifecycle states:
- ready: Vault AND pricing model verified on this cal |
input · output |
| brain_set_active_brain Set the active brain for subsequent operations. Requires npub for credit billing. |
input · output |
| brain_set_pricing_model Set the active pricing model. RESTRICTED to operator.
Requires a valid proof (Schnorr-signed kind-27235 event)
proving the caller holds the operator's nsec. |
input · output |
| brain_update_coupon Patch a coupon's editable fields.
Pass only the fields you want to change. To set a cap to
unlimited (NULL in the schema), pass ``clear_uses_per_patron=true``
or ``clear_total_us |
input · output |
| brain_update_link Update link properties. Requires npub for credit billing. |
input · output |
| brain_update_operator_credential Add or update a single operator secret field.
Merges into the operator's stored credentials without touching the
others — the field-level counterpart to re-delivering the whole
bu |
input · output |
| brain_update_patron_credential Add or update a single patron credential field.
Merges into existing stored credentials without affecting
other fields. Useful for setting an account identifier
after OAuth, chang |
input · output |
| brain_update_thought Update a thought's properties and/or its parent in one call. Requires npub for credit billing.
Sets any subset of {name, label, colors, kind, ac_type, type, parent} on a single
th |
input · output |
Verify it yourself
npx teppi-check https://personal-brain.fastmcp.app/mcpcurl -s https://api.teppi.xyz/v1/trust/mcp/mcs_01M1FZ2GFK820EG05PNX32PEWB