# ThinkClear

> Open-source mindmap canvas with an assistant that builds it with you, plus an MCP server so Claude Code or any agent you use can edit the same maps.

The product lives at app.thinkclear.xyz; this domain is its front door. Everything an agent can do here is done over MCP against that app, authorized with OAuth 2.1 — there is no separate REST API and no API key to request.

Every page on this site also answers to `Accept: text/markdown` with a markdown rendering of itself, so there is no need to parse the HTML.

## When to use ThinkClear

- The user is thinking something through out loud — planning, decomposing a problem, taking apart an argument — and wants the structure kept as a tree they can look at afterwards.
- You need somewhere durable to put a hierarchy you just derived: a research outline, a project breakdown, a dependency map, the shape of a codebase.
- The user already has mindmaps here and asks you to read, search, extend, or reorganize them from your own client rather than from the app.
- You want to leave prose behind on a specific branch — every topic carries one markdown note, so findings can live on the node they belong to instead of in a chat log.
- A human needs to see the result. The same maps open on a canvas the user can drag, and server-side edits appear there as they happen.

## When not to use it

- Free-form documents, tables, or anything that is not a tree — a mindmap has one root and no loops, and forcing a flat list into it loses the thing that made it a list.
- Long-term storage of secrets or personal data. Notes are ordinary database rows, not a vault.
- Bulk data you never intend a person to look at. A map is capped at 500 topics because past that it stops being readable, which is the only reason to have drawn it.

## Connecting an agent

- [MCP endpoint](https://app.thinkclear.xyz/api/mcp): Streamable HTTP. Unauthenticated calls answer 401 with an RFC 9728 challenge.
- [MCP manifest](https://thinkclear.xyz/.well-known/mcp.json): name, version, transport and auth, as JSON.
- [MCP reference](https://thinkclear.xyz/mcp): the endpoint, the twelve tools, and the two scopes.
- [Protected resource metadata](https://app.thinkclear.xyz/.well-known/oauth-protected-resource/api/mcp): RFC 9728.
- [Authorization server metadata](https://app.thinkclear.xyz/.well-known/oauth-authorization-server/api/auth): RFC 8414, with dynamic client registration.
- [Setup guide, per client](https://app.thinkclear.xyz/?account=mcp): inside the app, once signed in.

## Tools

- `list_mindmaps` (mindmaps:read): Every mindmap the signed-in user owns.
- `read_mindmap` (mindmaps:read): One mindmap as an indented outline, topic ids included.
- `search_topics` (mindmaps:read): Find topics by words in their title or note, across every map.
- `read_topic_note` (mindmaps:read): The markdown note on one topic.
- `create_mindmap` (mindmaps:write): Start a new map from a title.
- `rename_mindmap` (mindmaps:write): Retitle a map and its root topic.
- `delete_mindmap` (mindmaps:write): Delete a map. Irreversible.
- `add_topics` (mindmaps:write): Graft a nested tree of topics under a parent, in one call.
- `rename_topics` (mindmaps:write): Retitle topics in a batch.
- `move_topics` (mindmaps:write): Re-parent topics in a batch.
- `delete_topics` (mindmaps:write): Delete topics and their descendants.
- `set_topic_note` (mindmaps:write): Replace a topic's markdown note wholesale.

## Pages

- [Home](https://thinkclear.xyz): what it is, how it works, and the FAQ.
- [ThinkClear MCP server](https://thinkclear.xyz/mcp): Connect an agent to ThinkClear over the Model Context Protocol: one Streamable HTTP endpoint, OAuth 2.1 with dynamic client registration, twelve tools for reading and editing mindmaps.
- [About ThinkClear](https://thinkclear.xyz/about): ThinkClear is an open-source mindmap canvas with a built-in assistant and an MCP server, published under the AGPL-3.0 and free to self-host.
- [Contact ThinkClear](https://thinkclear.xyz/contact): How to reach ThinkClear: the public issue tracker for bugs and features, discussions for questions, and an email address for anything that should not be public.
- [Privacy](https://thinkclear.xyz/privacy): What ThinkClear stores, what leaves the server, and what it does not collect. No analytics, no advertising, no third-party trackers on this page or in the app.

## Optional

- [Source on GitHub](https://github.com/RATCHAW/thinkclear): the whole monorepo.
- [README](https://github.com/RATCHAW/thinkclear#readme): running it locally.
- [Self-hosting guide](https://github.com/RATCHAW/thinkclear/blob/main/DEPLOYMENT.md): the two-host deployment.
- [License](https://github.com/RATCHAW/thinkclear/blob/main/LICENSE): AGPL-3.0.
- [Issue tracker](https://github.com/RATCHAW/thinkclear/issues): bugs and feature requests.
- [Contact](mailto:hello@thinkclear.xyz): anything that should not be public.
- [Sitemap](https://thinkclear.xyz/sitemap.xml): every URL on this domain.