# brains

> https://usebrains.app
> brains is a personal knowledge store built for AI agents. Fast MCP access, write-back discipline, OAuth-ready.

## What brains does

brains gives AI agents persistent, searchable memory via a markdown wiki server. It exposes an MCP server and a REST API so any agent — Claude, ChatGPT, Copilot, Cursor, Gemini — can read and write structured knowledge.

## Connect via MCP

MCP Server URL: https://lets.usebrains.app/mcp

Add to your MCP client config:
```json
{ "brains": { "type": "http", "url": "https://lets.usebrains.app/mcp" } }
```

## API Key Auth

All endpoints require: `Authorization: Bearer <your-api-key>`

## Session Protocol

Pull context: `GET /api/v1/session/bundle?tags=<slug>&maxBytes=150000&maxPages=30`
Push changes: `POST /api/v1/session/bundle` with bundle text body

Via MCP tools: `pull_session_bundle` / `push_session_bundle`

## Full Agent Guide

https://usebrains.app/agent-guide

## OpenAPI

https://lets.usebrains.app/openapi.json