Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Personal Brain

REMOTE · PERSONAL-BRAIN.FASTMCP.APP

FastMCP server for TheBrain API — AI access to a personal knowledge graph, Tollbooth-monetized

0 this week 36 Trust /100

Last scanned (17 hours ago)

Scores higher than 19% of remote servers

Reachable. Last reached 21 Nov 2026.

Category Memory and Knowledge

Recent critical change

Authorization (15 Oct 2026). See the changelog before you install this server.

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →

Endpoint Security89
Transport & Reachability0
Schema Quality & AI Usability0
  • Schema blocked by authentication: the endpoint requires auth we don't have to read it. See how to fix → Unverified
Stability & Change Management0
  • Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage0
  • Tool coverage blocked by authentication: the endpoint requires auth we don't have to read its tools.Unverified
Tool Safety0
  • Tool safety blocked by authentication: the endpoint requires auth we don't have to read its tools.Unverified
Capabilities0
  • Capabilities blocked by authentication: the endpoint requires auth we don't have to read them. See how to fix → Unverified

Unverified: 6 categories

Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm. Claim this server and supply a read-only token to verify it and lift the score.

What we tested

Checks we ran (5)

  • TLS certificate
  • Authorization
  • HTTPS
  • HSTS header
  • DNSSEC

Checks we could not complete (6)

These are gaps on our side, not findings about this hosted endpoint. We only credit what we can confirm, so a category made up entirely of them scores 0.

  • Transport in Transport & Reachability (scores 0 for this)Transport blocked by authentication: the endpoint requires auth we don't have to verify streamable-http.
  • Schema quality in Schema Quality & AI Usability (scores 0 for this)Schema blocked by authentication: the endpoint requires auth we don't have to read it.
  • Stability in Stability & Change Management (scores 0 for this)Stability not yet verified: not enough scan history yet (needs a 30-day window).
  • Tool coverage in Tool Coverage (scores 0 for this)Tool coverage blocked by authentication: the endpoint requires auth we don't have to read its tools.
  • Tool safety in Tool Safety (scores 0 for this)Tool safety blocked by authentication: the endpoint requires auth we don't have to read its tools.
  • Capabilities in Capabilities (scores 0 for this)Capabilities blocked by authentication: the endpoint requires auth we don't have to read them.

Does not apply to this hosted endpoint (2)

  • Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
  • Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 6 Nov 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 18 Oct 26 0
    • Endpoint reachability: reachable → behind authorisation ▼ security
    • Stability: pass → unverified ▼ security
    • Tool safety: pass → unverified ▼ security
    • Transport: pass → unverified ▼ security
    • Authorization: fail → pass ▲ security
    • First check of Authorization: partial security
    • Capabilities: pass → unverified ▼ functional
    • Tool coverage: 100 → unverified ▼ functional
    • First check of Schema quality: unverified functional
  • 15 Oct 26 0

    First indexed and scored.

    • Authorization: unverified → fail ▼ critical
    • Tool “brain_update_operator_credential” rewrote its description, which is the text the model reads security
    • Tool “brain_delete_operator_credential” rewrote its description, which is the text the model reads security
    • Tool “brain_delete_coupon” is now declared destructive security
    • Tool “brain_delete_link” is now declared destructive security
    • Tool “brain_create_or_update_note” is now declared destructive security
    • Tool “brain_receive_credentials” is now declared destructive security
    • Tool “brain_get_attachment_content” is now declared destructive security
    • Tool “brain_receive_npub_proof” is now declared destructive security
    • Tool “brain_delete_operator_credential” is now declared destructive security
    • Tool “brain_receive_patron_credentials” is now declared destructive security
    • Tool “brain_delete_thought” is now declared destructive security
    • Tool “brain_delete_attachment” is now declared destructive security
    • Tool “brain_update_link” is now declared destructive security
    • Tool “brain_brain_query” is now declared destructive security
    • Tool “brain_publish_nostr_profile” is now declared destructive security
    • Tool “brain_forget_coupon” is now declared destructive security
    • Tool “brain_set_pricing_model” is now declared destructive security
    • Tool “brain_reset_pricing_model” is now declared destructive security
    • Tool “brain_update_thought” is now declared destructive security
    • Tool “brain_delete_patron_credential” is now declared destructive security
    • Tool “brain_forget_credentials” is now declared destructive security
    • Tool “brain_morph_thought” is now declared destructive security
    • Schema quality: 167 → 209 ▼ functional
    • Tool coverage: 76% → 100% ▲ functional
    • Schema quality: good → excellent functional
    • Destructive annotations: All 10 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation. functional
    • Server version: 3.4.7 → 1.17.8 functional
    • “brain_report_issue” reworded the description of “dpop_token” cosmetic
    • “brain_check_balance” reworded the description of “dpop_token” cosmetic
    • “brain_scan_orphans” reworded the description of “dpop_token” cosmetic
    • “brain_set_pricing_model” reworded the description of “model_json” cosmetic
    • “brain_morph_thought” reworded the description of “dpop_token” cosmetic
    • “brain_delete_attachment” reworded the description of “dpop_token” cosmetic
    • “brain_scan_orphans” reworded the description of “npub” cosmetic
    • “brain_purchase_credits” reworded the description of “dpop_token” cosmetic
    • “brain_get_brain_stats” reworded the description of “dpop_token” cosmetic
    • “brain_check_payment” reworded the description of “dpop_token” cosmetic
    • “brain_get_thought_graph” reworded the description of “dpop_token” cosmetic
    • “brain_event_for_person” reworded the description of “npub” cosmetic
    • “brain_get_thought_by_name” reworded the description of “dpop_token” cosmetic
    • “brain_append_to_note” reworded the description of “dpop_token” cosmetic
    • “brain_adoption_status” reworded the description of “authority_npub” cosmetic
    • “brain_get_link” reworded the description of “dpop_token” cosmetic
    • “brain_get_tags” reworded the description of “npub” cosmetic
    • “brain_create_link” reworded the description of “dpop_token” cosmetic
    • “brain_update_coupon” reworded the description of “valid_until” cosmetic
    • “brain_request_adoption” reworded the description of “dpop_token” cosmetic
    • “brain_list_coupons” reworded the description of “dpop_token” cosmetic
    • “brain_check_proof_status” reworded the description of “dpop_token” cosmetic
    • “brain_update_coupon” reworded the description of “total_uses” cosmetic
    • “brain_delete_coupon” reworded the description of “dpop_token” cosmetic
    • “brain_set_active_brain” reworded the description of “dpop_token” cosmetic
    • “brain_get_thought_graph_paginated” reworded the description of “npub” cosmetic
    • “brain_update_coupon” reworded the description of “coupon_id” cosmetic
    • “brain_update_coupon” reworded the description of “clear_total_uses” cosmetic
    • “brain_restore_neon_schema” reworded the description of “dpop_token” cosmetic
    • “brain_delete_coupon” reworded the description of “coupon_id” cosmetic
    • “brain_update_link” reworded the description of “dpop_token” cosmetic
    • “brain_create_link” reworded the description of “npub” cosmetic
    • “brain_forget_coupon” reworded the description of “npub” cosmetic
    • “brain_update_coupon” reworded the description of “valid_from” cosmetic
    • “brain_receive_npub_proof” reworded the description of “dpop_token” cosmetic
    • “brain_get_brain” reworded the description of “dpop_token” cosmetic
    • “brain_get_patron_credential_fields” reworded the description of “dpop_token” cosmetic
    • “brain_check_price” reworded the description of “dpop_token” cosmetic
    • “brain_delete_operator_credential” reworded the description of “dpop_token” cosmetic
    • “brain_update_patron_credential” reworded the description of “dpop_token” cosmetic
    • “brain_get_types” reworded the description of “npub” cosmetic
    • “brain_update_link” reworded the description of “npub” cosmetic
    • “brain_delete_link” reworded the description of “dpop_token” cosmetic
    • “brain_list_my_coupons” reworded the description of “npub” cosmetic
    • “brain_update_coupon” reworded the description of “uses_per_patron” cosmetic
    • “brain_oracle_lookup_member” reworded the description of “npub” cosmetic
    • “brain_list_my_coupons” reworded the description of “dpop_token” cosmetic
    • “brain_check_price” reworded the description of “npub” cosmetic
    • “brain_get_attachment_content” reworded the description of “npub” cosmetic
    • “brain_receive_patron_credentials” reworded the description of “dpop_token” cosmetic
    • “brain_forget_coupon” reworded the description of “coupon_id” cosmetic
    • “brain_get_nostr_profile” reworded the description of “npub” cosmetic
    • “brain_receive_credentials” reworded the description of “dpop_token” cosmetic
    • “brain_forget_credentials” reworded the description of “dpop_token” cosmetic
    • “brain_get_note” reworded the description of “npub” cosmetic
    • “brain_brain_query” reworded the description of “npub” cosmetic
    • “brain_add_url_attachment” reworded the description of “dpop_token” cosmetic
    • “brain_update_coupon” reworded the description of “discount_percent” cosmetic
    • “brain_get_thought_graph” reworded the description of “npub” cosmetic
    • “brain_update_coupon” reworded the description of “clear_uses_per_patron” cosmetic
    • “brain_append_to_note” reworded the description of “npub” cosmetic
    • “brain_add_file_attachment” reworded the description of “dpop_token” cosmetic
    • “brain_get_attachment” reworded the description of “dpop_token” cosmetic
    • “brain_create_thought” reworded the description of “dpop_token” cosmetic
    • “brain_update_operator_credential” reworded the description of “dpop_token” cosmetic
    • “brain_delete_thought” reworded the description of “npub” cosmetic
    • “brain_morph_thought” reworded the description of “npub” cosmetic
    • “brain_redeem_coupon” reworded the description of “dpop_token” cosmetic
    • “brain_update_coupon” reworded the description of “dpop_token” cosmetic
    • “brain_get_brain” reworded the description of “npub” cosmetic
    • “brain_reset_pricing_model” reworded the description of “dpop_token” cosmetic
    • “brain_get_patron_onboarding_status” reworded the description of “dpop_token” cosmetic
    • “brain_get_modifications” reworded the description of “dpop_token” cosmetic
    • “brain_get_tags” reworded the description of “dpop_token” cosmetic
    • “brain_redeem_coupon” reworded the description of “code” cosmetic
    • “brain_brain_query” reworded the description of “dpop_token” cosmetic
    • “brain_delete_patron_credential” reworded the description of “dpop_token” cosmetic
    • “brain_get_types” reworded the description of “dpop_token” cosmetic
    • “brain_update_thought” reworded the description of “dpop_token” cosmetic
    • “brain_receive_patron_credentials” reworded the description of “sender_npub” cosmetic
    • “brain_delete_attachment” reworded the description of “npub” cosmetic
    • “brain_get_attachment_content” reworded the description of “dpop_token” cosmetic
    • “brain_create_or_update_note” reworded the description of “dpop_token” cosmetic
    • “brain_get_attachment” reworded the description of “npub” cosmetic
    • “brain_get_brain_stats” reworded the description of “npub” cosmetic
    • “brain_list_brains” reworded the description of “npub” cosmetic
    • “brain_get_link” reworded the description of “npub” cosmetic
    • “brain_get_modifications” reworded the description of “npub” cosmetic
    • “brain_search_thoughts” reworded the description of “npub” cosmetic
    • “brain_forget_coupon” reworded the description of “dpop_token” cosmetic
    • “brain_mint_coupon” reworded the description of “dpop_token” cosmetic
    • “brain_adoption_status” reworded the description of “dpop_token” cosmetic
    • “brain_account_statement” reworded the description of “dpop_token” cosmetic
    • “brain_request_patron_credentials” reworded the description of “sender_npub” cosmetic
    • “brain_add_url_attachment” reworded the description of “npub” cosmetic
    • Tool “brain_get_thought_by_name” changed its title: Find a thought by name cosmetic
    • Tool “brain_check_price” changed its title: Check price cosmetic
    • Tool “brain_get_attachment_content” changed its title: Download an attachment cosmetic
    • Tool “brain_list_constraint_types” changed its title: Constraint types cosmetic
    • Tool “brain_update_patron_credential” changed its title: Update patron credential cosmetic
    • Tool “brain_get_note” changed its title: Get a note cosmetic
    • Tool “brain_list_attachments” changed its title: List attachments cosmetic
    • Tool “brain_update_operator_credential” changed its title: Update operator credential cosmetic
    • Tool “brain_delete_coupon” changed its title: Delete coupon cosmetic
    • Tool “brain_notarize_ledger” changed its title: Notarize ledger cosmetic
    • Tool “brain_set_active_brain” changed its title: Set the active brain cosmetic
    • Tool “brain_restore_neon_schema” changed its title: Restore database schema cosmetic
    • Tool “brain_get_modifications” changed its title: Brain change log cosmetic
    • Tool “brain_delete_patron_credential” changed its title: Delete patron credential cosmetic
    • Tool “brain_get_patron_credential_fields” changed its title: Patron credential fields cosmetic
    • Tool “brain_update_link” changed its title: Update a link cosmetic
    • Tool “brain_get_pricing_model” changed its title: Pricing model cosmetic
    • Tool “brain_account_statement” changed its title: Account statement cosmetic
    • Tool “brain_report_issue” changed its title: Report an issue cosmetic
    • Tool “brain_request_npub_proof” changed its title: Request npub proof cosmetic
    • Tool “brain_scan_orphans” changed its title: Rescue orphan thoughts cosmetic
    • Tool “brain_redeem_coupon” changed its title: Redeem coupon cosmetic
    • Tool “brain_publish_nostr_profile” changed its title: Publish Nostr profile cosmetic
    • Tool “brain_list_coupons” changed its title: Coupons cosmetic
    • Tool “brain_oracle_network_advisory” changed its title: Network advisories cosmetic
    • Tool “brain_mint_coupon” changed its title: Mint coupon cosmetic
    • Tool “brain_get_brain” changed its title: Get a brain cosmetic
    • Tool “brain_get_thought_graph_paginated” changed its title: Thought graph by page cosmetic
    • Tool “brain_check_payment” changed its title: Check payment cosmetic
    • Tool “brain_purchase_credits” changed its title: Buy credits cosmetic
    • Tool “brain_search_thoughts” changed its title: Search thoughts cosmetic
    • Tool “brain_create_thought” changed its title: Create a thought cosmetic
    • Tool “brain_list_my_coupons” changed its title: My coupons cosmetic
    • Tool “brain_delete_link” changed its title: Delete a link cosmetic
    • Tool “brain_request_patron_credentials” changed its title: Request patron credentials cosmetic
    • Tool “brain_oracle_lookup_member” changed its title: Look up a DPYC member cosmetic
    • Tool “brain_add_url_attachment” changed its title: Attach a URL cosmetic
    • Tool “brain_account_statement_infographic” changed its title: Account statement infographic cosmetic
    • Tool “brain_event_for_person” changed its title: Log an event with a person cosmetic
    • Tool “brain_oracle_get_tax_rate” changed its title: DPYC tax rate cosmetic
    • Tool “brain_get_types” changed its title: Thought types cosmetic
    • Tool “brain_delete_operator_credential” changed its title: Delete operator credential cosmetic
    • Tool “brain_get_brain_stats” changed its title: Brain statistics cosmetic
    • Tool “brain_session_status” changed its title: Session status cosmetic
    • Tool “brain_get_operator_onboarding_status” changed its title: Operator onboarding status cosmetic
    • Tool “brain_get_patron_onboarding_status” changed its title: Patron onboarding status cosmetic
    • Tool “brain_receive_credentials” changed its title: Receive credentials cosmetic
    • Tool “brain_update_coupon” changed its title: Update coupon cosmetic
    • Tool “brain_set_pricing_model” changed its title: Set pricing model cosmetic
    • Tool “brain_append_to_note” changed its title: Append to a note cosmetic
    • Tool “brain_check_proof_status” changed its title: Check proof status cosmetic
    • Tool “brain_receive_npub_proof” changed its title: Receive npub proof cosmetic
    • Tool “brain_add_file_attachment” changed its title: Attach a file cosmetic
    • Tool “brain_update_thought” changed its title: Update a thought cosmetic
    • Tool “brain_forget_coupon” changed its title: Forget coupon cosmetic
    • Tool “brain_request_adoption” changed its title: Request adoption cosmetic
    • Tool “brain_list_notarizations” changed its title: Notarizations cosmetic
    • Tool “brain_create_link” changed its title: Create a link cosmetic
    • Tool “brain_get_notarization_proof” changed its title: Notarization proof cosmetic
    • Tool “brain_check_authority_balance” changed its title: Authority balance cosmetic
    • Tool “brain_adoption_status” changed its title: Adoption status cosmetic
    • Tool “brain_morph_thought” changed its title: Move or retype a thought cosmetic
    • Tool “brain_service_status” changed its title: Service status cosmetic
    • Tool “brain_get_thought” changed its title: Get a thought cosmetic
    • Tool “brain_request_credential_channel” changed its title: Open credential channel cosmetic
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Probed https://personal-brain.fastmcp.app/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=*.fastmcp.app CN=Amazon RSA 2048 S23,O=Amazon,C=US 17 Nov 2026 3 Jun 2027 RSA 2048 SHA256-RSA 4407b73bd482c3685ebd1ace7d12a943
SANs: *.fastmcp.app
CN=Amazon RSA 2048 S23,O=Amazon,C=US (CA) CN=Amazon Root CA 1,O=Amazon,C=US 8 Jul 2026 7 Jul 2029 RSA 2048 SHA256-RSA 61ce4e80a87b563b954db8e843c3e74a3d3c59b8
CN=Amazon Root CA 1,O=Amazon,C=US (CA) CN=Starfield Services Root Certificate Authority - G2,O=Starfield Technologies\, Inc.,L=Scottsdale,ST=Arizona,C=US 25 May 2015 31 Dec 2037 RSA 2048 SHA256-RSA 67f944a2a27cdf3fac2ae2b01f908eeb9c4c6

Background: What to check on a remote MCP endpoint →

DNSSEC insecure

Validation of personal-brain.fastmcp.app. — Not signed

Zone DS Keys Algorithms Outcome
. Trust anchor 20326, 38696 8, 8 Verified
app. DS published 23684 8 Verified
fastmcp.app. No DS Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation
Authentication Enforced and verified

The endpoint asked for a token and published valid RFC 9728 metadata describing how to get one.

Result Enforced and verified
Enforced On connection
HTTP status 401

WWW-Authenticate challenge Bearer resource_metadata="https://personal-brain.fastmcp.app/.well-known/oauth-protected-resource/mcp"

Bearer resource_metadata="https://personal-brain.fastmcp.app/.well-known/oauth-protected-resource/mcp"
Header Value
www-authenticate Bearer resource_metadata="https://personal-brain.fastmcp.app/.well-known/oauth-protected-resource/mcp"

Protected resource metadata

Document https://personal-brain.fastmcp.app/.well-known/oauth-protected-resource/mcp
Retrieved Yes
Resource https://personal-brain.fastmcp.app/mcp
Authorisation server https://personal-brain.fastmcp.app/

Background: How OAuth 2.1 works in the 2026 MCP spec →

Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://personal-brain.fastmcp.app/mcp Auth required 401
http (plaintext) http://personal-brain.fastmcp.app/mcp HTTPS enforced 301 https://personal-brain.fastmcp.app/mcp
MCP tools · 84 exposed · ~16,344 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
brain_account_statement ~180

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 is the patron's spending account — not the operator's Authority tax balance. Free — no credits consumed. Proof of npub ownership is required to prevent statement-scraping of arbitrary patrons.

NameTypeReqDescription
daysinteger–Number of days of daily usage history to include (default 30).
dpop_tokenstringyesProof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name.
npubstringyesThe patron's Nostr public key (npub1...).

Structured output declared, but exposes no named fields.

No examples provided.

brain_account_statement_infographic ~180

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, health gauge, tranche table, and tool usage breakdown. Costs 1 api_sat per call. Proof is verified by ``debit_or_deny`` before any cost is incurred.

NameTypeReqDescription
daysinteger–Number of days of daily usage history to include (default 30).
dpop_tokenstringyesProof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name.
npubstringyesThe Nostr public key (npub1...) whose statement to render.

Structured output declared, but exposes no named fields.

No examples provided.

brain_add_file_attachment ~200

Add a file attachment to a thought. Requires npub for credit billing.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
file_name––Name for the attachment (optional)
file_pathstringyesPath to the file to attach
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
thought_idstringyesThe ID of the thought

Structured output declared, but exposes no named fields.

No examples provided.

brain_add_url_attachment ~202

Add a URL attachment to a thought. Requires npub for credit billing.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
name––Name for the URL attachment (auto-fetched if not provided)
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
thought_idstringyesThe ID of the thought
urlstringyesThe URL to attach

Structured output declared, but exposes no named fields.

No examples provided.

brain_adoption_status ~131

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 / provisioned).

NameTypeReqDescription
authority_npubstringyesThe npub of the Authority the request was sent to.
dpop_tokenstring–Proof that the caller holds the operator's npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by the operator whose `u` tag is this tool's name.

Structured output declared, but exposes no named fields.

No examples provided.

brain_append_to_note ~388

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-status note — never for ordinary emphasis, labels, or whole clauses. Overusing bold buries the links and makes notes hard to scan; let thought-links and source links carry the visual emphasis. Put web sources on a quiet "Sources:" line rather than bolding labels like "TL;DR" or "Source". Linking to other thoughts. To link from inside a note to another thought, write a wikilink: [[Thought Name]] or [[Thought Name|display text]]. The tool resolves it to the correct in-plex thought link automatically — do not hand-write brain:// URLs or paste GUIDs. If a name is ambiguous or not found, the tool leaves the [[...]] literal and returns it in unresolved; disambiguate by pinning the id with [[#<thoughtId>]]. For external web pages, use normal markdown links: [text](https://…).

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
markdownstringyesMarkdown content to append
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
thought_idstringyesThe ID of the thought

Structured output declared, but exposes no named fields.

No examples provided.

brain_brain_query ~343

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, DELETE, and RETURN. ⚠️ Name-based matching (MATCH by name, WHERE CONTAINS/STARTS WITH/=~) resolves through the vendor's search/name index, which is incomplete on large brains (TheBrainTech/thebrain-api-quickstart-python#1): a query may fail to match a thought that provably exists. An empty match set is NOT proof of absence — do not CREATE/MERGE a node on the assumption it is missing without an ID-based check (get_thought). Matching by ID is reliable; matching by name inherits the index's blind spots.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
confirmboolean–Set to true to confirm and execute a DELETE operation.
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
querystringyesA BrainQuery string (Cypher subset).

Structured output declared, but exposes no named fields.

No examples provided.

brain_check_authority_balance ~72

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 certified and the operator must call purchase_credits on the Authority. This is the operator's own funding — not a patron balance. Free.

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

brain_check_balance ~166

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 balance at the Authority (needed to certify patron purchases), use authority_check_balance instead. Free — no credits required. Proof of npub ownership is required to prevent anyone-with-the-registry from enumerating balances.

NameTypeReqDescription
dpop_tokenstringyesProof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name.
npubstringyesThe Nostr public key (npub1...) whose balance to check.

Structured output declared, but exposes no named fields.

No examples provided.

brain_check_payment ~152

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 credit-grant front-running by an observer of the invoice ID.

NameTypeReqDescription
dpop_tokenstringyesProof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name.
invoice_idstringyesThe invoice ID returned by purchase_credits.
npubstringyesThe Nostr public key (npub1...) that purchased the invoice.

Structured output declared, but exposes no named fields.

No examples provided.

brain_check_price ~246

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.

NameTypeReqDescription
dpop_tokenstring–Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name.
npubstring–Optional patron npub; with it, the preview includes that patron's coupons and constraint effects.
tool_idstringyesEither the tool's UUID (from the pricing model) or a bare capability string (e.g. ``"deal_scenario"``). FE callers usually have the capability name; this resolves both so the FE doesn't need to deriv…
tool_kwargsstring–Optional JSON object with tool call parameters for ad valorem / categorical-multiplier pricing preview (e.g. '{"amount_sats": 5000}' or '{"difficulty": "sovereign", "mode": "live"}').

Structured output declared, but exposes no named fields.

No examples provided.

brain_check_proof_status ~171

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 burning credits on a guaranteed failure. Expiry is read from the grant itself; the only store consulted is the patron's revocation watermark. Free, no side effects — touches no relay.

NameTypeReqDescription
dpop_tokenstring–Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name.
patron_npubstring–Required. The patron's npub (npub1...).

Structured output declared, but exposes no named fields.

No examples provided.

brain_create_link ~264

Create a relationship between two thoughts by ID. Requires npub for credit billing.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
color––Link color in hex format
direction––Direction flags
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
name––Label for the link
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
relationintegeryesRelation type (1=Child, 2=Parent, 3=Jump, 4=Sibling)
thickness––Link thickness (1-10)
thought_id_astringyesID of the first thought
thought_id_bstringyesID of the second thought
type_id––ID of link type

Structured output declared, but exposes no named fields.

No examples provided.

brain_create_or_update_note ~392

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 unconfirmed-status note — never for ordinary emphasis, labels, or whole clauses. Overusing bold buries the links and makes notes hard to scan; let thought-links and source links carry the visual emphasis. Put web sources on a quiet "Sources:" line rather than bolding labels like "TL;DR" or "Source". Linking to other thoughts. To link from inside a note to another thought, write a wikilink: [[Thought Name]] or [[Thought Name|display text]]. The tool resolves it to the correct in-plex thought link automatically — do not hand-write brain:// URLs or paste GUIDs. If a name is ambiguous or not found, the tool leaves the [[...]] literal and returns it in unresolved; disambiguate by pinning the id with [[#<thoughtId>]]. For external web pages, use normal markdown links: [text](https://…).

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
markdownstringyesMarkdown content for the note
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
thought_idstringyesThe ID of the thought

Structured output declared, but exposes no named fields.

No examples provided.

brain_create_thought ~371

Create a new thought with optional type, color, label, and parent link. Requires npub for credit billing.

NameTypeReqDescription
ac_typeinteger–Access type (0=Public, 1=Private)
background_color––Background color in hex format (e.g., "#0000ff")
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
foreground_color––Foreground color in hex format (e.g., "#ff0000")
kindinteger–Kind of thought to create — 1=Normal (default) or 2=Type. Tags and Events are NOT created via kind (the API rejects those values); model them as Normal thoughts carrying the appropriate type_id from…
label––Optional label for the thought
namestringyesThe name of the thought
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
relation––Relation type if linking (1=Child, 2=Parent, 3=Jump, 4=Sibling)
source_thought_id––ID of the source thought to link from
type_id––ID of the thought type to assign

Structured output declared, but exposes no named fields.

No examples provided.

brain_delete_attachment ~169

Delete an attachment. Requires npub for credit billing.

NameTypeReqDescription
attachment_idstringyesThe ID of the attachment
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.

Structured output declared, but exposes no named fields.

No examples provided.

brain_delete_coupon ~145

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 surfaces orphan references as warnings. RESTRICTED to operator — requires proof.

NameTypeReqDescription
coupon_idstringyesThe id of the coupon to delete (from list_coupons).
dpop_tokenstring–Proof that the caller holds the operator's npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by the operator whose `u` tag is this tool's name.

Structured output declared, but exposes no named fields.

No examples provided.

brain_delete_link ~177

Permanently delete a link by ID. Cannot be undone. Requires npub for credit billing.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
link_idstringyesThe ID of the link
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.

Structured output declared, but exposes no named fields.

No examples provided.

brain_delete_operator_credential ~265

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_credentials``, which wipes the whole row. Use it to retire a leftover after an SDK cutover (a Prefect key after Modal, or a stored but untemplated orphan like ``anthropic_api_key``) without taking the operator down for a full re-delivery. Stored-but-untemplated fields are first-class: the delete is keyed on what is vaulted, not on what the current template declares. Idempotent — already-absent fields report ``removed: false`` without rewriting the vault. RESTRICTED to the operator — requires the operator's proof (a kind-27235 event or a proof grant); patron proofs are rejected. A deletion is as destructive as a write.

NameTypeReqDescription
dpop_tokenstringyesProof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name.
fieldstringyesThe operator credential field to remove (templated or not).

Structured output declared, but exposes no named fields.

No examples provided.

brain_delete_patron_credential ~142

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 the patron's sensitive credential vault.

NameTypeReqDescription
dpop_tokenstringyesProof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name.
fieldstringyesThe credential field name to remove.
npubstringyesThe patron's Nostr public key (npub1...).

Structured output declared, but exposes no named fields.

No examples provided.

brain_delete_thought ~237

Permanently delete a thought by ID. Cannot be undone. Requires npub for credit billing.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
confirmboolean–If True, verify the deletion against the authoritative change-log (a logged DELETED entry) and attach a ``confirmation`` block. The command store already 404s a deleted thought; this adds an audit-gr…
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
thought_idstringyesThe ID of the thought

Structured output declared, but exposes no named fields.

No examples provided.

brain_event_for_person ~220

Create an Event+Person+Day in one action. Requires npub for credit billing.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
datestringyesFlexible date string (ISO, natural language, relative)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
event_name––Custom event name (auto-generated if omitted)
notes––Optional markdown note for the Event
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
personstringyesFull name or thought ID (UUID)

Structured output declared, but exposes no named fields.

No examples provided.

brain_forget_coupon ~162

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 window allows. Free — requires proof of ``npub``.

NameTypeReqDescription
coupon_idstringyesThe id of the redeemed coupon to remove (from list_my_coupons).
dpop_tokenstring–Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name.
npubstringyesThe patron's Nostr public key (npub1...).

Structured output declared, but exposes no named fields.

No examples provided.

brain_forget_credentials ~153

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 proof of npub ownership — a deletion is as destructive as a write.

NameTypeReqDescription
dpop_tokenstringyesProof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name.
npubstringyesThe Nostr public key (npub1...) whose credentials to forget.
servicestringyesThe credential service to forget.

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_attachment ~171

Get metadata about an attachment. Requires npub for credit billing.

NameTypeReqDescription
attachment_idstringyesThe ID of the attachment
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_attachment_content ~188

Get the binary content of an attachment. Requires npub for credit billing.

NameTypeReqDescription
attachment_idstringyesThe ID of the attachment
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
save_to_path––Optional path to save the file locally

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_brain ~155

Get details about a specific brain. Requires npub for credit billing.

NameTypeReqDescription
brain_idstringyesThe ID of the brain
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_brain_stats ~160

Get statistics about a brain. Requires npub for credit billing.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_link ~172

Get details about a specific link. Requires npub for credit billing.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
link_idstringyesThe ID of the link
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_modifications ~507

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 every operation promptly — CREATED (101), DELETED (102), CHANGED_NAME (103), SET_TYPE (203), MOVED_LINK (402), etc. — with old→new values and timestamps. Use it for two things: 1. **Confirm a write landed** — after a mutation, query with start_time set to just before it and check for the matching entry. This is the authoritative read-after-write check (stronger than the cached graph, and it confirms deletes and type/link changes the graph hides). The heavy mutating tools also expose a ``confirm=True`` flag that does this for you. 2. **Discover recent / peer activity** — "what changed since T" so an agent can pick up where others left off. ⚠️ ``userId`` is the TheBrain *account* owner, shared by every agent using this operator's key — it distinguishes human-desktop vs API activity, NOT one agent from another. Peer discovery here is by time + content, not by author.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
end_time––End time for logs (ISO format)
max_logsinteger–Maximum number of logs to fetch from the API (pre-filter)
mod_types––Only return entries whose modType is in this list (e.g. [102] for deletes)
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
source_id––Only return entries for this thought/link ID
source_type––Only return entries of this SourceType (2=Thought, 3=Link)
start_time––Start time for logs (ISO format)

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_nostr_profile ~101

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, picture, banner, nip05, website, lud16) or an empty profile if none is published.

NameTypeReqDescription
npubstring–The Nostr public key (npub1...) whose profile to read.

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_notarization_proof ~69

Generate a Merkle inclusion proof that a patron's balance was included in a Bitcoin-notarized snapshot.

NameTypeReqDescription
notarization_idstringyesThe notarization record ID.
npubstringyesThe patron's Nostr public key (npub1...).

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_note ~189

Get the note content for a thought. Requires npub for credit billing.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
formatstring–Output format (markdown, html, or text)
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
thought_idstringyesThe ID of the thought

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_operator_onboarding_status ~56

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 status, use get_patron_onboarding_status instead. Free.

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_patron_credential_fields ~191

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 secrets vaulted before timestamps were recorded). Values are never exposed — use this to verify which fields are configured and how old each one is. Free. Proof of npub ownership is required: the list of configured fields is itself sensitive (reveals which integrations a patron has set up).

NameTypeReqDescription
dpop_tokenstringyesProof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name.
npubstringyesThe patron's Nostr public key (npub1...).

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_patron_onboarding_status ~168

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/OAuth2 services (Schwab), reports that no patron credentials are needed. Free. Proof of npub ownership is required because credential presence is sensitive information about the patron's setup.

NameTypeReqDescription
dpop_tokenstringyesProof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name.
patron_npubstringyesThe patron's Nostr public key (npub1...).

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_pricing_model ~50

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 schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_tags ~159

Get all tags in a brain. Requires npub for credit billing.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_thought ~173

Get details about a specific thought. Requires npub for credit billing.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
thought_idstringyesThe ID of the thought

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_thought_by_name ~282

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 to be incomplete on large brains (upstream: TheBrainTech/thebrain-api-quickstart-python#1): a hit is real, but a MISS is NOT proof the thought is absent. Never conclude a thought does not exist from a null result here — verify by ID with get_thought, or by graph traversal from a known neighbour, before creating a duplicate.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
name_exactstringyesThe exact name to match (case-sensitive)
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_thought_graph ~320

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 response cache), which lags writes by hours-to-days and reflects creates but NOT updates or deletes — it can return renamed/retyped thoughts with their old values and even serve thoughts that were already deleted (upstream: TheBrainTech/thebrain-api-quickstart-python#2). Use this for fast traversal of established structure and for finding older thought IDs. Do NOT use it to verify a recent write — confirm mutations by ID with get_thought, which reads the authoritative command store.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
include_siblingsboolean–Include sibling thoughts in the graph
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
thought_idstringyesThe ID of the thought

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_thought_graph_paginated ~334

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_graph (upstream: TheBrainTech/thebrain-api-quickstart-python#2) — lags writes by hours-to-days and does not reflect updates or deletes. Use for traversal/ID discovery, never as read-after-write verification; confirm mutations by ID with get_thought.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
cursor––Pagination cursor from a previous response
directionstring–"older" (newest first) or "newer" (oldest first)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
page_sizeinteger–Number of results per page (default 10)
relation_filter––Filter by relation: "child", "parent", "jump", "sibling"
thought_idstringyesThe ID of the thought

Structured output declared, but exposes no named fields.

No examples provided.

brain_get_types ~161

List all thought types defined in the brain. Requires npub for credit billing.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.

Structured output declared, but exposes no named fields.

No examples provided.

brain_list_attachments ~173

List all attachments for a thought. Requires npub for credit billing.

NameTypeReqDescription
brain_id––The ID of the brain (uses active brain if not specified)
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.
thought_idstringyesThe ID of the thought

Structured output declared, but exposes no named fields.

No examples provided.

brain_list_brains ~132

List available brains.

NameTypeReqDescription
dpop_tokenstring–Proof that the caller holds npub. Either the grant envelope that receive_npub_proof returned, or the raw JSON of a kind-27235 Nostr event signed by npub: content "", a `u` tag holding this tool's exa…
npubstring–The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it.

Structured output declared, but exposes no named fields.

No examples provided.

brain_list_canonical_identities ~249

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 its tools. Reconcile uses this output to UUID-join against the stored pricing model — no name-based UUID derivation, no guessing. Includes both ToolIdentity-seeded tools and any UUID recorded by ``@paid_tool`` that is missing from the registry. The latter appear with ``registered: false`` (and in the top-level ``unregistered`` array) so Reconcile can flag deploy drift instead of silently reporting clean when a live tool was never seeded (#174). If the operator renames a function or rebrands a slug, the mcp_name in this output changes but tool_id stays. That's the whole point of the canonical-UUID design. Also diffs the live FastMCP wire surface against the registry. Tools exposed on the wire but absent from the registry appear in ``unregistered`` so Reconcile can flag deploy drift instead of silently under-reporting (issue #175). Free, no side effects.

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

brain_list_constraint_types ~50

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 pipeline. Free — no credits required.

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

brain_list_coupons ~121

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_uses``. RESTRICTED to operator — requires proof.

NameTypeReqDescription
dpop_tokenstring–Proof that the caller holds the operator's npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by the operator whose `u` tag is this tool's name.

Structured output declared, but exposes no named fields.

No examples provided.

brain_list_my_coupons ~147

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_limit`` / ``total_limit``). Free — requires proof of ``npub``.

NameTypeReqDescription
dpop_tokenstring–Proof that the caller holds npub: the grant envelope from receive_npub_proof, or the raw JSON of a kind-27235 Nostr event signed by npub whose `u` tag is this tool's name.
npubstringyesThe patron's Nostr public key (npub1...).

Structured output declared, but exposes no named fields.

No examples provided.

brain_list_notarizations ~51

List recent Bitcoin notarization records.

NameTypeReqDescription
limitinteger–Maximum records to return (default 20).
statusstring–Optional filter (e.g., 'submitted', 'confirmed').

Structured output declared, but exposes no named fields.

No examples provided.

Install

How do I install the Personal Brain MCP server?

Personal Brain is a hosted endpoint at https://personal-brain.fastmcp.app/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

remote · personal-brain.fastmcp.app

# add to Claude Code
claude mcp add --transport http lonniev-personalbrain-mcp 'https://personal-brain.fastmcp.app/mcp'
Common questions

What is the Personal Brain MCP server?

Personal Brain is an MCP server listed in the public MCP registry as io.github.lonniev/personalbrain-mcp. FastMCP server for TheBrain API, AI access to a personal knowledge graph, Tollbooth-monetized. This page covers its hosted endpoint (https://personal-brain.fastmcp.app/mcp).

Is the Personal Brain MCP server safe to use?

Personal Brain scores 36 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the Personal Brain MCP server expose?

Personal Brain exposes 84 tools: brain_check_balance, brain_purchase_credits, brain_check_payment, brain_restore_credits, brain_account_statement, and 79 more. Their descriptions and schemas cost roughly 16,344 tokens of context every time the server is loaded.

Does the Personal Brain MCP server require authentication?

Yes. Personal Brain asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

Is the Personal Brain MCP server still maintained?

Personal Brain is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What did VerifyMCP test on the Personal Brain MCP server?

VerifyMCP ran 5 checks on Personal Brain, covering TLS certificate, Authorization, HTTPS, HSTS header and 1 more. 6 items could not be completed, a gap on our side rather than a finding about Personal Brain: Transport, Schema quality, Stability, Tool coverage and 2 more. 6 categories score 0 for that reason, because we only credit what we can confirm. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.