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
| Tool | What it does |
|---|---|
list_components | Returns all components available under your license |
get_component_docs | Fetches the full API documentation for a specific component |
create_project | Creates a Modula project and returns a stable CDN bundle URL |
select_components | Sets the component list for a project |
get_theming_instructions | Returns CSS theming guidelines for Modula components |
create_lesson_instructions | Returns the full Lesson Skill workflow |
Supported AI clients
| AI client | Connection method |
|---|---|
| Claude.ai | Settings → Customize → Connectors |
| Claude Design | Inherits connectors from Claude.ai |
| Claude Code | CLI command or ~/.claude.json config |
| ChatGPT | Settings → Apps & Connectors (Business / Enterprise / Edu) |
| Codex | codex.json config file |
| Cursor | Settings → Features → MCP |
| GitHub Copilot | VS Code settings or mcp.json config |
| Gemini | Coming soon |
Select your AI client from the list above or from the sidebar for step-by-step setup instructions.