hex-mcp MCP server

Name: hex-mcp MCP server
Author: franccesco

@franccesco

Repository

About hex-mcp MCP server

A MCP server to interact with Hex projects

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "hex-mcp": {
      "command": "uv",
      "args": [
        "run",
        "hex-mcp",
        "run"
      ],
      "env": {
        "HEX_API_KEY": "",
        "HEX_API_URL": ""
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is hex-mcp?

hex-mcp is a Model Context Protocol server for Hex that provides tools to list, search, get details, run, and cancel Hex projects. It is designed for users who want to manage Hex projects programmatically, especially through AI agents in environments like Cursor.

How to use hex-mcp?

Install hex-mcp with uv add hex-mcp or pip install hex-mcp. Configure it using the hex-mcp config command (recommended) or by setting the HEX_API_KEY and HEX_API_URL environment variables. To run the server, use hex-mcp run and add a corresponding entry to your MCP client's configuration (e.g., .cursor/mcp.json for Cursor).

Key features of hex-mcp

list_hex_projects: Lists available Hex projects
search_hex_projects: Search for Hex projects by pattern
get_hex_project: Get detailed information about a specific project
get_hex_run_status: Check the status of a project run
get_hex_project_runs: Get the history of project runs
run_hex_project: Execute a Hex project
cancel_hex_run: Cancel a running project

Use cases of hex-mcp

Automate Hex project execution from AI assistants or CI/CD pipelines.
Monitor project run status and history without leaving your development environment.
Quickly locate and inspect Hex projects by name or pattern.
Integrate Hex project management into multi-step AI workflows.

FAQ from hex-mcp

How do I install hex-mcp?

Use uv add hex-mcp (recommended) or pip install hex-mcp. Verify the installation with hex-mcp --version.

How do I configure hex-mcp?

Use the hex-mcp config command, passing your API key and optionally an API URL (defaults to https://app.hex.tech/api/v1). This saves a config file to ~/.hex-mcp/config.yml. Alternatively, set the HEX_API_KEY and HEX_API_URL environment variables.

What tools does hex-mcp provide?

hex-mcp includes tools for listing, searching, and getting details on projects, as well as running, cancelling, and checking the status of project runs.

How do I use hex-mcp with Cursor?

Add a hex-mcp entry to your .cursor/mcp.json file using either "command": "uv", "args": ["run", "hex-mcp", "run"] or "command": "hex-mcp", "args": ["run"] if hex-mcp is in your PATH.