> 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.
Server URL
## 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 %}
OAuth authorization screen
## 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.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.genesis.autify.com/settings/connection-settings/mcp-server.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.