MCP.so
Sign In

hex-mcp MCP server

@franccesco

Basic information

Category

Other

License

AGPL-3.0 license

Transports

stdio

Author

franccesco

About hex-mcp MCP server

A MCP server to interact with Hex projects

hex-mcp MCP server 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": ""
      }
    }
  }
}

hex-mcp MCP server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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.

Frequently asked questions

1

How do I install hex-mcp?

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

2

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.

3

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.

4

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.

5

Is hex-mcp stable?

The MCP server and CLI are still in development and subject to breaking changes.

Comments

More Other MCP servers