Getting Started

WitWiki is a persistent knowledge base for you and your AI agents. Every insight your agent uncovers, every decision it makes, every pattern it recognizes — stored, linked, and waiting for the next session.

Create an account

Sign up at witwiki.io, then create your first project from the dashboard. Each project is an isolated knowledge base — give it a name that matches your codebase or product area.

Generate an API key

Go to Keys in the top nav and create a new key. Copy it — you will need it to connect your agent via MCP. Set the role to agent for programmatic MCP access.

Connect via MCP

Add this to your project's .mcp.json (or your editor's MCP settings):

{
  "mcpServers": {
    "witwiki": {
      "url": "https://witwiki-api.fly.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with the key you just generated.

Verify the connection

In your agent session, call wiki_getIndex. You should get back the index page (empty by default). You are connected.

Next: see the Integration guide to add the CLAUDE.md or AGENTS.md snippet that teaches your agent how and when to use the wiki.