MCP Overview
What MCP is, why Noukai uses it, and how it enables AI-assisted flow building.
What is MCP?
The Model Context Protocol (MCP) is a standard for AI assistants to interact with external tools. It defines how tools are discovered, called, and how results are returned.
Why Noukai Uses MCP
Noukai exposes 45 MCP tools that let AI assistants build and manage flows programmatically. Instead of a user clicking through a UI, they describe what they want and the AI handles it.
Architecture
- Transport: Streamable HTTP (stateless, per-request auth)
- Auth: OAuth 2.1 + PKCE (browser sign-in, auto-refresh)
- Server URL:
https://api.noukai.xyz/api/v1/mcp
Tool Categories
| Category | Count | Purpose |
|---|---|---|
| Read | 9 | Inspect flows, blocks, history, run traces |
| Structural | 11 | Add, remove, move, wrap blocks |
| Lifecycle | 2 | Create and delete flows |
| Content | 8 | Update prompts, schemas, configs |
| Checkpoint | 2 | Save and delete prompt snapshots |
| Versioning | 2 | Publish and set production |
| Object Model | 3 | Reusable schema types |
| Test Case | 7 | Create, manage, and execute tests |
| Bulk Update | 1 | Atomic multi-field block update |
Next Steps
- Setup — configure your MCP client
- Tool Listing — all 45 tools with schemas
- Common Workflows — step-by-step recipes