Personal Brain
REMOTE · PERSONAL-BRAIN.FASTMCP.APP
FastMCP server for TheBrain API — AI access to a personal knowledge graph, Tollbooth-monetized
Available components
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.
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
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- The endpoint enforces authorisation, advertised via RFC 9728 protected-resource metadata. View diagnostics → Pass
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
- The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents. View diagnostics → Partial
Transport & Reachability0
- Transport blocked by authentication: the endpoint requires auth we don't have to verify streamable-http. See how to fix → View diagnostics → Unverified
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.
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 →
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
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 |
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 →
brain_account_statement 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.
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | Number of days of daily usage history to include (default 30). |
| dpop_token | string | yes | 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. |
| npub | string | yes | The patron's Nostr public key (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
brain_account_statement_infographic 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.
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | Number of days of daily usage history to include (default 30). |
| dpop_token | string | yes | 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. |
| npub | string | yes | The Nostr public key (npub1...) whose statement to render. |
Structured output declared, but exposes no named fields.
No examples provided.
brain_add_file_attachment Attach a file ~200
Add a file attachment to a thought. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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_path | string | yes | Path to the file to attach |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| thought_id | string | yes | The ID of the thought |
Structured output declared, but exposes no named fields.
No examples provided.
brain_add_url_attachment Attach a URL ~202
Add a URL attachment to a thought. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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) |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| thought_id | string | yes | The ID of the thought |
| url | string | yes | The URL to attach |
Structured output declared, but exposes no named fields.
No examples provided.
brain_adoption_status 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).
| Name | Type | Req | Description |
|---|---|---|---|
| authority_npub | string | yes | The npub of the Authority the request was sent to. |
| dpop_token | string | – | 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 Append to a 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://…).
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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… |
| markdown | string | yes | Markdown content to append |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| thought_id | string | yes | The ID of the thought |
Structured output declared, but exposes no named fields.
No examples provided.
brain_brain_query Run a BrainQuery ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| confirm | boolean | – | Set to true to confirm and execute a DELETE operation. |
| dpop_token | string | – | 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… |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| query | string | yes | A BrainQuery string (Cypher subset). |
Structured output declared, but exposes no named fields.
No examples provided.
brain_check_authority_balance 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 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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | yes | 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. |
| npub | string | yes | The Nostr public key (npub1...) whose balance to check. |
Structured output declared, but exposes no named fields.
No examples provided.
brain_check_payment 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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | yes | 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. |
| invoice_id | string | yes | The invoice ID returned by purchase_credits. |
| npub | string | yes | The Nostr public key (npub1...) that purchased the invoice. |
Structured output declared, but exposes no named fields.
No examples provided.
brain_check_price 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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | 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. |
| npub | string | – | Optional patron npub; with it, the preview includes that patron's coupons and constraint effects. |
| tool_id | string | yes | Either 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_kwargs | string | – | 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 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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | 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_npub | string | – | Required. The patron's npub (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
brain_create_link Create a link ~264
Create a relationship between two thoughts by ID. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| color | – | – | Link color in hex format |
| direction | – | – | Direction flags |
| dpop_token | string | – | 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 |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| relation | integer | yes | Relation type (1=Child, 2=Parent, 3=Jump, 4=Sibling) |
| thickness | – | – | Link thickness (1-10) |
| thought_id_a | string | yes | ID of the first thought |
| thought_id_b | string | yes | ID 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 Write a 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://…).
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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… |
| markdown | string | yes | Markdown content for the note |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| thought_id | string | yes | The ID of the thought |
Structured output declared, but exposes no named fields.
No examples provided.
brain_create_thought Create a thought ~371
Create a new thought with optional type, color, label, and parent link. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| ac_type | integer | – | 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_token | string | – | 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") |
| kind | integer | – | 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 |
| name | string | yes | The name of the thought |
| npub | string | – | 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 Delete an attachment ~169
Delete an attachment. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| attachment_id | string | yes | The ID of the attachment |
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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… |
| npub | string | – | 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 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.
| Name | Type | Req | Description |
|---|---|---|---|
| coupon_id | string | yes | The id of the coupon to delete (from list_coupons). |
| dpop_token | string | – | 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 Delete a link ~177
Permanently delete a link by ID. Cannot be undone. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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_id | string | yes | The ID of the link |
| npub | string | – | 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 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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | yes | 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. |
| field | string | yes | The operator credential field to remove (templated or not). |
Structured output declared, but exposes no named fields.
No examples provided.
brain_delete_patron_credential 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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | yes | 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. |
| field | string | yes | The credential field name to remove. |
| npub | string | yes | The patron's Nostr public key (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
brain_delete_thought Delete a thought ~237
Permanently delete a thought by ID. Cannot be undone. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| confirm | boolean | – | 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_token | string | – | 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… |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| thought_id | string | yes | The ID of the thought |
Structured output declared, but exposes no named fields.
No examples provided.
brain_event_for_person Log an event with a person ~220
Create an Event+Person+Day in one action. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| date | string | yes | Flexible date string (ISO, natural language, relative) |
| dpop_token | string | – | 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 |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| person | string | yes | Full name or thought ID (UUID) |
Structured output declared, but exposes no named fields.
No examples provided.
brain_forget_coupon 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``.
| Name | Type | Req | Description |
|---|---|---|---|
| coupon_id | string | yes | The id of the redeemed coupon to remove (from list_my_coupons). |
| dpop_token | string | – | 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. |
| npub | string | yes | The patron's Nostr public key (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
brain_forget_credentials 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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | yes | 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. |
| npub | string | yes | The Nostr public key (npub1...) whose credentials to forget. |
| service | string | yes | The credential service to forget. |
Structured output declared, but exposes no named fields.
No examples provided.
brain_get_attachment Get an attachment ~171
Get metadata about an attachment. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| attachment_id | string | yes | The ID of the attachment |
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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… |
| npub | string | – | 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 Download an attachment ~188
Get the binary content of an attachment. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| attachment_id | string | yes | The ID of the attachment |
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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… |
| npub | string | – | 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 Get a brain ~155
Get details about a specific brain. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | string | yes | The ID of the brain |
| dpop_token | string | – | 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… |
| npub | string | – | 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 Brain statistics ~160
Get statistics about a brain. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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… |
| npub | string | – | 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 Get a link ~172
Get details about a specific link. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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_id | string | yes | The ID of the link |
| npub | string | – | 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 Brain change log ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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_logs | integer | – | 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) |
| npub | string | – | 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 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.
| Name | Type | Req | Description |
|---|---|---|---|
| npub | string | – | The Nostr public key (npub1...) whose profile to read. |
Structured output declared, but exposes no named fields.
No examples provided.
brain_get_notarization_proof Notarization proof ~69
Generate a Merkle inclusion proof that a patron's balance was included in a Bitcoin-notarized snapshot.
| Name | Type | Req | Description |
|---|---|---|---|
| notarization_id | string | yes | The notarization record ID. |
| npub | string | yes | The patron's Nostr public key (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
brain_get_note Get a note ~189
Get the note content for a thought. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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… |
| format | string | – | Output format (markdown, html, or text) |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| thought_id | string | yes | The ID of the thought |
Structured output declared, but exposes no named fields.
No examples provided.
brain_get_operator_onboarding_status 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 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).
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | yes | 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. |
| npub | string | yes | The patron's Nostr public key (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
brain_get_patron_onboarding_status 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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | yes | 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_npub | string | yes | The patron's Nostr public key (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
brain_get_pricing_model 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 Tags ~159
Get all tags in a brain. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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… |
| npub | string | – | 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 Get a thought ~173
Get details about a specific thought. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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… |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| thought_id | string | yes | The ID of the thought |
Structured output declared, but exposes no named fields.
No examples provided.
brain_get_thought_by_name Find a 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.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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_exact | string | yes | The exact name to match (case-sensitive) |
| npub | string | – | 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 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.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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_siblings | boolean | – | Include sibling thoughts in the graph |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| thought_id | string | yes | The ID of the thought |
Structured output declared, but exposes no named fields.
No examples provided.
brain_get_thought_graph_paginated Thought graph by page ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| cursor | – | – | Pagination cursor from a previous response |
| direction | string | – | "older" (newest first) or "newer" (oldest first) |
| dpop_token | string | – | 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… |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| page_size | integer | – | Number of results per page (default 10) |
| relation_filter | – | – | Filter by relation: "child", "parent", "jump", "sibling" |
| thought_id | string | yes | The ID of the thought |
Structured output declared, but exposes no named fields.
No examples provided.
brain_get_types Thought types ~161
List all thought types defined in the brain. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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… |
| npub | string | – | 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 List attachments ~173
List all attachments for a thought. Requires npub for credit billing.
| Name | Type | Req | Description |
|---|---|---|---|
| brain_id | – | – | The ID of the brain (uses active brain if not specified) |
| dpop_token | string | – | 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… |
| npub | string | – | The patron's Nostr public key (npub1...). Tool fees are paid from this patron's balance; dpop_token proves the caller holds it. |
| thought_id | string | yes | The ID of the thought |
Structured output declared, but exposes no named fields.
No examples provided.
brain_list_brains List brains ~132
List available brains.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | 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… |
| npub | string | – | 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 Tool 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 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 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.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | 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 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``.
| Name | Type | Req | Description |
|---|---|---|---|
| dpop_token | string | – | 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. |
| npub | string | yes | The patron's Nostr public key (npub1...). |
Structured output declared, but exposes no named fields.
No examples provided.
brain_list_notarizations Notarizations ~51
List recent Bitcoin notarization records.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum records to return (default 20). |
| status | string | – | Optional filter (e.g., 'submitted', 'confirmed'). |
Structured output declared, but exposes no named fields.
No examples provided.
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
claude mcp add --transport http lonniev-personalbrain-mcp 'https://personal-brain.fastmcp.app/mcp'
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.