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

# MCP overview

> Expose your skill library to AI agents via the Model Context Protocol.

SkillCreator includes an MCP (Model Context Protocol) server that lets AI agents query your skill library directly. Instead of reading static files, agents can discover, inspect, and use skills dynamically.

## What MCP enables

With the MCP server running, an AI agent can:

* **List skills.** Browse your entire skill library.
* **Read skills.** Load skill content on demand.
* **Check health.** View eval scores and quality metrics.
* **Search.** Find skills by keyword or tag.
* **Inspect runs.** View skill execution history.

## How it works

```mermaid theme={"dark"}
flowchart LR
    A[AI Agent] -->|MCP Protocol| B[SkillCreator MCP Server]
    B -->|RPC| C[Desktop Runtime]
    C --> D[SQLite Database]
    C --> E[Skill Files]
```

The MCP server is a stdio-based server that proxies all tool calls to the desktop app's local RPC endpoint. It runs as a subprocess of the desktop app.

## Auto-registration

On first launch, SkillCreator automatically registers its MCP server with detected agent runtimes:

| Runtime        | Config file                                                       |
| -------------- | ----------------------------------------------------------------- |
| Claude Code    | `~/.claude.json`                                                  |
| Cursor         | `~/.cursor/mcp.json`                                              |
| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Gemini CLI     | `~/.gemini/settings.json`                                         |

<Info>
  Auto-registration only adds the server entry if the config file exists. It does not overwrite existing configurations.
</Info>

Auto-registration also writes tool approval permissions to `~/.claude/settings.json` for Claude Code.

## Headless mode

The MCP server can run independently of the desktop app:

```bash theme={"dark"}
skillcreator --skillcreator-mcp
```

This starts a headless MCP server that connects to the local runtime. Useful for CI environments or when you want MCP without the GUI.