API Reference

The MindWiki API exposes a set of tools that allow AI assistants to interact with your vault. These tools are available via the Model Context Protocol (MCP).

Base URL

Your MCP endpoint:

https://api.mindwiki.io/mcp?token=YOUR_MCP_TOKEN

Generate an MCP token from your account dashboard.

Protocol

All tools are accessed via MCP JSON-RPC calls. If you're using Claude Code, Claude Desktop, or Cursor with MCP support, add the server to your MCP configuration and the tools will be available automatically.

Rate Limits

Rate limits are per-user, enforced per minute:

  • Free plan: 30 requests/minute
  • Pro plan: 120 requests/minute
  • Teams plan: 300 requests/minute

Exceeding the limit returns HTTP 429. The X-RateLimit-Limit and X-RateLimit-Remaining headers are included in every response.

Authentication

All requests require authentication via an MCP token. See Authentication for setup details.