> ## Documentation Index
> Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Brain Tools

> The 15 naive_brain_* MCP tools agents use to read and write the company knowledge base + memory.

When the **brain** primitive is enabled on the AccountKit, agents connected to the Naive MCP server get 15 `naive_brain_*` tools. Every tool enforces the primitive's kit gate and per-tenant plan quota; destructive tools additionally route through the approval gate (agent calls return a pending-approval payload the model relays to the owner). Credit costs match the API.

## Tools

| Tool                           | Description                                           | Notes                      |
| ------------------------------ | ----------------------------------------------------- | -------------------------- |
| `naive_brain_query`            | Ask the knowledge base; grounded answer + citations.  | 10 credits                 |
| `naive_brain_add_document`     | Ingest a document (`text` \| `url` \| `file_base64`). | 5 credits                  |
| `naive_brain_replace_document` | Replace/refresh a document in place.                  | 5 credits                  |
| `naive_brain_list_documents`   | List documents + status.                              |                            |
| `naive_brain_get_document`     | Get one document (refreshed status).                  |                            |
| `naive_brain_delete_document`  | Delete a document.                                    | sensitive · approval-gated |
| `naive_brain_list`             | List knowledge bases.                                 |                            |
| `naive_brain_create`           | Create a knowledge base.                              |                            |
| `naive_brain_remember`         | Write a durable semantic memory episode.              |                            |
| `naive_brain_recall`           | Recall structured facts/entities/episodes.            |                            |
| `naive_brain_think`            | Synthesize memory + docs with gaps.                   | 10 credits                 |
| `naive_brain_graph`            | Entity/relation knowledge graph.                      |                            |
| `naive_brain_timeline`         | Chronological memory events/facts.                    |                            |
| `naive_brain_forget`           | Tombstone/forget a memory scope.                      | sensitive · approval-gated |
| `naive_brain_delete`           | Delete a knowledge base + documents.                  | sensitive · approval-gated |

## Example

```json theme={"theme":"css-variables"}
{
  "tool": "naive_brain_query",
  "arguments": { "question": "What is our refund policy?" }
}
```

Sensitive tools return a pending-approval payload when called by an agent:

```json theme={"theme":"css-variables"}
{ "status": "pending_approval", "approval": { "id": "appr-uuid", "action_type": "brain.forget" } }
```

See the [Brain guide](/docs/getting-started/brain) for concepts and the [API reference](/docs/api-reference/brain/overview) for wire details. For non-company knowledge (the open web), use the `search` tools instead.