Connect your AI

Modula exposes a Model Context Protocol (MCP) server that any compatible AI assistant can connect to. Once connected, the AI gains access to the full Modula toolset — it can browse the component library, fetch documentation, create projects, and deliver production-ready interactive lessons — all from a natural-language prompt.

The MCP server

The Modula MCP server is available at:

https://mcp.modula.dev/mcp

It uses the Streamable HTTP transport — a single HTTPS endpoint that accepts POST requests. This is the modern MCP transport and is supported by all major AI clients.

How authentication works

The server uses OAuth 2.1 with PKCE. The first time your AI calls a Modula tool in a session, it opens a browser window to complete the Modula login flow. Once you sign in and grant permission, the connection is established and persists for that session.

You only authenticate once per client — subsequent sessions use a refresh token automatically.

What the AI can do once connected

ToolWhat it does
list_componentsReturns all components available under your license
get_component_docsFetches the full API documentation for a specific component
create_projectCreates a Modula project and returns a stable CDN bundle URL
select_componentsSets the component list for a project
get_theming_instructionsReturns CSS theming guidelines for Modula components
create_lesson_instructionsReturns the full Lesson Skill workflow

Supported AI clients

AI clientConnection method
Claude.aiSettings → Customize → Connectors
Claude DesignInherits connectors from Claude.ai
Claude CodeCLI command or ~/.claude.json config
ChatGPTSettings → Apps & Connectors (Business / Enterprise / Edu)
Codexcodex.json config file
CursorSettings → Features → MCP
GitHub CopilotVS Code settings or mcp.json config
GeminiComing soon

Select your AI client from the list above or from the sidebar for step-by-step setup instructions.