MCP for AI agents

How it works

1. Create a personal API key in Settings → API key (shown once, starts with aago_).
2. Point your agent at https://aago.social/api/mcp with an Authorization: Bearer header.
3. Everything the agent touches is scoped to your documents only.

Tools

• documents_list — List documents in your workspace
• documents_search — Full-text search across documents
• documents_get — Read a single document with content
• documents_create — Create new documents and nested pages
• documents_update — Edit titles, content, covers, and flags
• documents_archive — Archive a document tree
• documents_restore — Restore from archive
• documents_duplicate — Copy a document
• documents_favorite — Star or unstar favorites

Client setup

{
  "mcpServers": {
    "aago": {
      "url": "https://aago.social/api/mcp",
      "headers": { "Authorization": "Bearer aago_..." }
    }
  }
}

codex mcp add aago \
  --url "https://aago.social/api/mcp" \
  --header "Authorization: Bearer aago_..."

{
  "mcp": {
    "aago": {
      "type": "remote",
      "url": "https://aago.social/api/mcp",
      "headers": { "Authorization": "Bearer aago_..." }
    }
  }
}

npx -y mcp-remote https://aago.social/api/mcp \
  --header "Authorization: Bearer aago_..."

Full walkthrough in Docs → MCP. Rotate a leaked key immediately in Settings — the old key stops working at once.