> ## Documentation Index
> Fetch the complete documentation index at: https://magica.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Connect AI assistants like Claude, Cursor, and Codex to Magica using the Model Context Protocol.

<Frame caption="Magica MCP — turn any AI assistant into a workflow operator.">
  <img className="block dark:hidden" src="https://mintcdn.com/galaxyai-f8150d75/DBhRDarFZNKVqMQi/logo/logo_light_theme.svg?fit=max&auto=format&n=DBhRDarFZNKVqMQi&q=85&s=6f2c433ff16ffb278918ac9ebdf0de20" alt="Magica MCP overview — AI assistants connecting to the Magica workflow engine" width="1474" height="411" data-path="logo/logo_light_theme.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/galaxyai-f8150d75/DBhRDarFZNKVqMQi/logo/logo_dark_theme.svg?fit=max&auto=format&n=DBhRDarFZNKVqMQi&q=85&s=12e176141e9a0793a64292bb91603779" alt="Magica MCP overview — AI assistants connecting to the Magica workflow engine" width="1474" height="411" data-path="logo/logo_dark_theme.svg" />
</Frame>

Magica provides a remote [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that lets AI assistants manage your workflows and runs directly. It supports the **Streamable HTTP** transport for session-aware clients and plain HTTP for simpler ones.

***

## Endpoint

```
https://api.magica.com/api/mcp
```

Authenticate with the same Bearer API key you use for the REST API. No separate signup needed.

***

## What you can do

Once connected, your assistant can build, run, monitor, and tear down workflows — all from a normal chat conversation.

<CardGroup cols={2}>
  <Card title="Run workflows" icon="play" href="/mcp-server/runs">
    Start a workflow by name or ID, monitor status, cancel mid-run.
  </Card>

  <Card title="Build workflows" icon="diagram-project" href="/mcp-server/building-workflows">
    Create, edit, and connect nodes from a conversation.
  </Card>

  <Card title="Direct model runs" icon="bolt" href="/mcp-server/tools">
    Run a single model (image, video, audio, LLM) without a workflow.
  </Card>

  <Card title="Browse the catalog" icon="cubes" href="/mcp-server/tools">
    Discover available node types, models, ports, and modes.
  </Card>
</CardGroup>

***

## Next steps

<CardGroup cols={2}>
  <Card title="Setup" icon="circle-play" href="/mcp-server/setup">
    Connect your client (Claude Code, Claude Desktop, Cursor) in under a minute.
  </Card>

  <Card title="Available Tools" icon="screwdriver-wrench" href="/mcp-server/tools">
    See all 23 MCP tools the server exposes.
  </Card>
</CardGroup>