> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/settings/connection-settings/mcp-server.md).

# MCP server

The **MCP Server** settings expose the connection information needed to integrate Autify Genesis with MCP (Model Context Protocol)-compatible clients such as Claude Desktop, Cursor, VS Code, and Claude Code.

## Server URL

You can view the endpoint URL to configure in MCP-compatible clients (Claude Desktop, Cursor, VS Code, and others). Click **Copy URL** to copy it.

<figure><img src="/files/oXigfGCzE0W5aV5o9B8v" alt="Screenshot of the server URL"><figcaption><p>Server URL</p></figcaption></figure>

## Authentication

The Genesis MCP server supports both OAuth 2.1 with PKCE and API key Bearer authentication.

* If your client uses OAuth, a browser window opens on first connection so you can approve access.
* If your client uses an API key, set the `Authorization: Bearer {API key}` header. To create an API key, see [API key management](/settings/organization-settings/api-key-management.md).

## Getting started (client-specific setup)

Set up the Genesis MCP server with the steps for the client you use.

### Claude Desktop

Claude Desktop supports only stdio connections. Use `mcp-remote` as a bridge and add the following to `claude_desktop_config.json`. Replace `SERVER-URL` with the Genesis **Server URL**.

```json
{
  "mcpServers": {
    "genesis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "SERVER-URL"
      ]
    }
  }
}
```

Alternatively, you can use Claude Connectors (**Settings** > **Connectors** > **Add custom connector**) to connect directly without editing config files. For more information, see [Getting started with custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp) in Claude Support.

### Cursor / VS Code

Add the following to `.cursor/mcp.json` or `.vscode/mcp.json`. Replace `SERVER-URL` with the Genesis **Server URL**.

```json
{
  "mcpServers": {
    "genesis": {
      "url": "SERVER-URL"
    }
  }
}
```

### Claude Code

Run the following command in your terminal to add the Genesis MCP server. For more information, see [Model Context Protocol (MCP)](https://code.claude.com/docs/en/mcp) in the Claude Code documentation.

```bash
claude mcp add --transport http genesis \
  https://genesis.autify.com/api/mcp
```

{% hint style="info" %}
For clients that use OAuth, a browser window opens on first connection so you can approve access.
{% endhint %}

<figure><img src="/files/JZPCwryr4j8Gn4BStV1Z" alt="Screenshot of the OAuth authorization screen"><figcaption><p>OAuth authorization screen</p></figcaption></figure>

## Available tools

The tools that connected MCP clients can call are organized by category. You can browse the latest list and search for tools in the **Available tools** card on the settings page. Each tool has one of the badges **Read**, **Write**, or **Destructive**.

The main categories and representative tools are listed below.

| Category           | Representative tools                                                                                                                                                                                                                                                 |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Organization       | `get_organization`, `list_organizations`                                                                                                                                                                                                                             |
| Workspaces         | `list_workspaces`, `get_workspace`, `list_codebases`                                                                                                                                                                                                                 |
| Workflow templates | `list_workflow_templates`, `get_workflow_template`, `create_workflow_template`, `update_workflow_template`, `duplicate_workflow_template`, `archive_workflow_template`                                                                                               |
| Workflow runs      | `run_workflow`, `get_workflow_execution`, `list_workflow_executions`, `cancel_workflow_execution`, `resume_workflow_execution`, `get_workflow_execution_usage`, `list_artifacts`, `get_artifact`, `get_artifact_traces`                                              |
| Files              | `list_files`, `get_file`, `get_file_content`, `create_file`, `update_file_content`, `delete_file`, `move_file`, `update_file_labels`, `list_file_labels`, `reindex_file`, `list_file_versions`, `delete_file_version`, `restore_file_version`, `rename_file_version` |
| Directories        | `list_directories`, `list_directory_contents`, `create_directory`, `update_directory`, `delete_directory`, `move_directory`, `get_directory_breadcrumbs`                                                                                                             |
| Knowledge base     | `search_knowledge_base`                                                                                                                                                                                                                                              |
| Metrics dashboard  | `list_metrics_widgets`, `list_metrics_widget_source_files`, `list_metrics_widget_versions`, `discover_metrics_widget_fields`, `get_metrics_widget_chart_data`, `create_metrics_widget`, `update_metrics_widget`                                                      |
| Video              | `analyze_video`                                                                                                                                                                                                                                                      |
| Bash               | `bash`                                                                                                                                                                                                                                                               |

For detailed descriptions, parameters, and the Read / Write / Destructive classification of each tool, check the search box on the **Available tools** card or the tool definitions retrieved by each MCP client.