theo

mcp

MCP Server & API Keys

Connect OpenCharts to external AI tools using the Model Context Protocol. Create flowcharts, notes, presentations, and run AI research from any MCP-compatible client.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI tools interact with external services through a unified interface. OpenCharts provides a public MCP server that exposes 19 tools and 3 resources, allowing you to manage your projects entirely from your development environment.

Your IDEWarp · Claude · Cursor · VS Code

MCP ProtocolStreamable HTTP + Bearer auth

OpenCharts19 tools · 3 resources

Create flowcharts, whiteboards, notes, and presentations from any AI client.

Ask Theo AI questions and get responses without leaving your editor.

Extract flowcharts from uploaded documents (PDFs, images, PPTXs).

Manage projects — list, update, delete — all via tool calls.

Quick start

Go to the Skill Store → MCP Server tab, or Settings → Integrations → MCP & API Keys.

Click "Create Key", give it a name (e.g. "Warp"), and copy the generated key immediately.

Expand your platform below and copy the config snippet.

Paste the config into your tool's MCP settings file, replacing {{YOUR_API_KEY}} with your key.

Test the connection — try calling the `whoami` tool to verify authentication.

API key securityAPI keys are hashed before storage — OpenCharts never stores the raw key. The full key is shown only once at creation. If lost, revoke and create a new one.

MCP endpoint

Server URL

https://opencharts.com/api/mcp

Transport: Streamable HTTP (POST). Authentication: Bearer token (API key or JWT).

Platform setup

Available tools (19)

Projects (8)

list_projectsList your projects with pagination and filters

get_projectGet full project data by ID

create_flowchartCreate a flowchart with nodes and edges

create_whiteboardCreate a whiteboard with Excalidraw elements

create_notesCreate notes from Markdown

create_presentationCreate a slide deck from an outline

update_projectUpdate metadata or content

delete_projectSoft-delete (30-day recovery)

AI (4)

ask_theoSingle-turn AI message (fast or think mode)

extract_flowchartExtract flowchart from a document

start_researchStart a deep research job

get_research_statusPoll research job progress

Notes (3)

get_note_contentExtract note as Markdown

append_to_noteAppend Markdown to a note

clip_to_noteSave web content as a clip

Templates (2)

list_templatesBrowse template gallery

use_templateCreate a project from a template

Account (2)

whoamiGet your user info

get_creditsCheck AI credit balance

Resources (3)

MCP resources provide read-only context that AI clients can retrieve without calling a tool.

project_listSummary of your recent projects (name, type, updated date). Helps AI decide which project to act on.

template_listAvailable templates with categories and usage counts. Lets AI suggest templates before creating from scratch.

credit_balanceCurrent AI credit balance and plan info. Prevents AI from burning credits on expensive operations when low.

API key management

Create

Copy

Use

Revoke

Create: Settings → Integrations → MCP & API Keys → Create Key. Each key has a name, scopes (read, write, ai), and a prefix shown for identification.

Revoke: Click the trash icon next to any active key. Revoked keys immediately stop working. You can create up to 10 active keys.

Scopes: By default, keys have full access (read + write + ai). Scope enforcement allows restricting keys to read-only access.

Rate limits

The MCP endpoint allows 120 requests per minute per user. AI tools that consume credits (ask_theo, extract_flowchart) are additionally gated by your plan's credit balance.

Troubleshooting

401 Unauthorized

Your API key is missing, expired, or revoked. Generate a new key in Settings → Integrations → MCP & API Keys.

429 Too Many Requests

You've exceeded the 120 requests/minute rate limit. Wait a moment and retry. AI-heavy tools also consume credits.

Tools not appearing in my AI client

Ensure the MCP server URL is exactly https://opencharts.com/api/mcp and the Authorization header uses "Bearer" prefix. Restart your AI client after changing config.

JWT expired mid-session

JWTs from Appwrite sessions expire after 15 minutes. For long-running integrations, use a persistent API key instead of a JWT.

AI credits consumed unexpectedly

Tools like ask_theo and extract_flowchart consume AI credits. Use the get_credits tool or the credit_balance resource to check your balance before expensive operations.

AI Chat

Conversational AI that creates flowcharts, whiteboards, notes, and presentations from natural language.

Integrations, Webhooks, and Zapier

Set up outbound webhooks, connect Zapier automations, and use practical recipe patterns.

Skills & Automation

Install skills to extend Theo, automate tasks with hooks and workflows, and manage credit guards.

Was this article helpful?