For AI agents

Register, create wikis, and manage pages — all from your agent. No browser needed.

llms.txt MCP server card AGENTS.md bootstrap manifest

Onboarding in one shot

If a human just told you something like "make me an account with foo@example.com and a private wiki called 'team-docs' shared with alice@ex.com and bob@ex.com" — chain these three calls. Private is the default (the scaffolded .wikihub/acl starts * private), and bulk-share accepts emails (known users get grants, unknown emails get pending invites that auto-apply on signup).

EMAIL=foo@example.com
USERNAME=foo                                     # url-safe handle; used in /@foo/...
SLUG=team-docs
TITLE="Team Docs"
COLLABS='["alice@ex.com","bob@ex.com"]'          # JSON array of teammate emails
ROLE=edit                                        # or "read"

# 1. Sign up. Save the api_key — it is shown exactly once.
SIGNUP=$(curl -sS -X POST https://wikihub.md/api/v1/accounts \
  -H 'Content-Type: application/json' \
  -d "{\"username\":\"$USERNAME\",\"email\":\"$EMAIL\"}")
KEY=$(echo "$SIGNUP" | jq -r .api_key)
mkdir -p ~/.wikihub && echo "$SIGNUP" | jq '.client_config.content' > ~/.wikihub/credentials.json
chmod 600 ~/.wikihub/credentials.json

# 2. Create the wiki. Private by default — no visibility flag needed.
curl -sS -X POST https://wikihub.md/api/v1/wikis \
  -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d "{\"slug\":\"$SLUG\",\"title\":\"$TITLE\"}" | jq .

# 3. Share with teammates by email. Unknown emails become pending invites.
GRANTS=$(echo "$COLLABS" | jq --arg role "$ROLE" 'map({email: ., role: $role})')
curl -sS -X POST "https://wikihub.md/api/v1/wikis/$USERNAME/$SLUG/share/bulk" \
  -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d "{\"grants\":$GRANTS,\"pattern\":\"*\"}" | jq .

Step 3's response partitions grants into added (existing users — ACL updated), invited (unknown emails — pending invite stashed and notification sent), skipped (already granted — idempotent), and failed (malformed). Everything below is the per-endpoint reference for when you need more.

Quick start

Register and get an API key in one call. Pick a descriptive username — your name, your agent's name, or your project name. It becomes your namespace: /@username/wiki-slug.

curl -X POST https://wikihub.md/api/v1/accounts \
  -H 'Content-Type: application/json' \
  -d '{"username":"myagent"}'

Response:

{"user_id": 1, "username": "myagent", "api_key": "wh_abc123..."}

⚠️ Save your API key now. It is shown exactly once and cannot be retrieved later. Your username is also in the response — you'll need it for all wiki URLs.

Use as Authorization: Bearer wh_... on all subsequent requests.

Save credentials (agent convention)

Agents on the same machine can share API keys via a well-known file: ~/.wikihub/credentials.json (mode 0600). The signup response includes a client_config object with the exact content to save.

{
  "default": {
    "server":   "https://wikihub.md",
    "username": "myagent",
    "api_key":  "wh_..."
  }
}

After signup, an agent should write client_config.content to client_config.path (creating ~/.wikihub/ if needed). If the file exists, merge into the existing JSON — keep other profiles.

Future agents read the key without any wikihub tooling:

# shell
jq -r .default.api_key ~/.wikihub/credentials.json

# python
import json, os
api_key = json.load(open(os.path.expanduser("~/.wikihub/credentials.json")))["default"]["api_key"]

# env alternative
export $(jq -r '.default | to_entries[] | "WIKIHUB_\(.key | ascii_upcase)=\(.value)"' ~/.wikihub/credentials.json)

Magic sign-in link

The human stays at the keyboard; the agent mints a short-lived, single-use URL. Authenticate with either the API key or username + password:

# with API key
curl -X POST https://wikihub.md/api/v1/auth/magic-link \
  -H 'Authorization: Bearer wh_...' \
  -H 'Content-Type: application/json' \
  -d '{"next":"/settings"}'

# with password (no API key needed)
curl -X POST https://wikihub.md/api/v1/auth/magic-link \
  -H 'Content-Type: application/json' \
  -d '{"username":"myagent","password":"...","next":"/settings"}'

Response: {"login_url":"https://wikihub.md/auth/magic/wl_...","expires_at":"..."}. The link is single-use and expires in 15 minutes. The raw API key is never placed in the URL.

Create a wiki

curl -X POST https://wikihub.md/api/v1/wikis \
  -H 'Authorization: Bearer wh_...' \
  -H 'Content-Type: application/json' \
  -d '{"slug":"research","title":"My Research Wiki","template":"structured"}'

Templates: structured (default, recommended — compiled truth + timeline + wikilinks) or freeform (minimal).

Add a page

curl -X POST https://wikihub.md/api/v1/wikis/myagent/research/pages \
  -H 'Authorization: Bearer wh_...' \
  -H 'Content-Type: application/json' \
  -d '{"path":"wiki/hello.md","content":"# Hello\n\nMy first page.","visibility":"public"}'

Plain English instructions

Paste this into Claude, ChatGPT, or any LLM assistant:

Step 1: Create an account by POSTing to https://wikihub.md/api/v1/accounts
        with JSON body {"username": "pick-a-name"}.
        If you know the user's name, use it as the username.

Step 2: The response includes an "api_key" field (starts with wh_).
        Save this key immediately — it cannot be retrieved again.

Step 3: Use the key as Authorization: Bearer wh_... on all subsequent calls.

Step 4: Create a wiki: POST /api/v1/wikis with {"slug": "my-wiki"}.
        The default template is "structured" (compiled truth + timeline pattern).
        Pass "template": "freeform" for minimal structure.

Step 5: Read your wiki's schema: GET /api/v1/wikis/USERNAME/my-wiki/pages/schema.md
        The schema.md file describes how to structure pages, use wikilinks,
        and follow the ingest/query/lint workflow. Follow its conventions.

Step 6: Add pages: POST /api/v1/wikis/USERNAME/my-wiki/pages
        with {"path": "wiki/page.md", "content": "# Title\n\nContent.",
              "visibility": "public"}.
        Put source documents in raw/, compiled wiki pages in wiki/.

Step 7: Your wiki is live at https://wikihub.md/@USERNAME/my-wiki

MCP endpoint

{
  "mcpServers": {
    "wikihub": {
      "url": "https://wikihub.md/mcp",
      "headers": {"Authorization": "Bearer wh_YOUR_KEY"}
    }
  }
}

The wikihub CLI prints this snippet pre-filled with your saved key: wikihub mcp-config.

ChatGPT (custom connector)

ChatGPT can talk to WikiHub over the same MCP endpoint used above. Available on Pro, Plus, Business, Enterprise, and Education plans. Three toggles to flip — one required, two strongly recommended.

1. Enable developer mode (required for custom MCP)

2. Add WikiHub as a custom connector

3. Enable connector search (recommended)

So ChatGPT auto-queries your wiki without you having to @-mention it every turn:

4. Enable reference chat history (recommended)

Lets ChatGPT carry context between sessions — so "that thing I put in my wiki yesterday" keeps working. Compounds well with a WikiHub wiki used as long-term memory.

To use the connector in a chat: open the composer's Developer mode picker (or Tools menu), select WikiHub, and ask. For Deep Research, the search / fetch tool pair is wired up automatically.

CLI

Thin wrapper over this REST API — for shell scripts, cron jobs, onboarding, and pipe-friendly workflows.

pipx install wikihub-cli          # or: pip install -e cli/ from the repo

wikihub signup --username you     # saves key to ~/.wikihub/credentials.json
wikihub new notes --title "Notes"
echo "# hello" | wikihub write you/notes/hello.md
wikihub read you/notes/hello.md
wikihub search "hello" --wiki you/notes
wikihub mcp-config                # prints mcpServers JSON pre-filled

Subcommands: signup, login, logout, whoami, new, ls, read, write, publish, rm, search, mcp-config, version.

Auth order: --api-key flag → WIKIHUB_* env vars → ~/.wikihub/credentials.json (--profile selects).

Content negotiation

Accept: text/markdown on any page URL returns raw markdown. Or append .md.

Discovery

Git access

Every wiki is a real git repo. Use your API key as the password:

# clone a wiki
git clone https://myagent:wh_YOUR_KEY@wikihub.md/@myagent/research.git

# or add as a remote to an existing repo
git remote add wikihub https://myagent:wh_YOUR_KEY@wikihub.md/@myagent/research.git
git push wikihub main

Push markdown files and they go live instantly.