H3 CLI MCP Server

by h3alfy
  • Apple
  • Linux

Integrations

  • Integrates with the h3-cli tool from GitHub to provide access to the Horizon3.ai API for security testing operations.

  • Enables fetching GraphQL schema documentation and executing raw GraphQL queries against the Horizon3.ai API for security testing and pentest management.

H3 CLI MCP Server

An MCP server that lets AI assistants and LLMs interact with the Horizon3.ai API using the official h3-cli tool.


What is this?

This MCP server exposes the full power of the h3-cli to your AI coding assistant (Claude, Cursor, VS Code, etc). It enables:

  • Scheduling and running pentests
  • Querying pentest results, weaknesses, impacts, hosts, credentials, and more
  • Automating security workflows and reporting
  • All via natural language and LLM tools

Note: You must have a working h3-cli installed and authenticated on your system. This server is a thin wrapper and does not manage your API keys or CLI installation.


Quick Copy-Paste: Add to Your MCP Client

Add this to your MCP client configuration (e.g., Cursor, Claude Desktop, Windsurf, etc):

{ "mcpServers": { "h3": { "command": "uvx", "args": ["horizon3ai/h3-cli-mcp"] } } }
  • No need to clone or build this repo manually—uvx will fetch and run the latest version automatically.
  • For advanced usage, see below.

Features

  • Full h3-cli API access: Everything you can do with the CLI, you can do via LLM tools.
  • GraphQL documentation: Fetch up-to-date docs for all available queries and mutations.
  • Parameter validation: Clear error messages and examples for all tool inputs.
  • Prompt templates: Built-in guidance for pagination, pivots, and common workflows.
  • Works with any MCP-compatible client: Claude, Cursor, Windsurf, VS Code, and more.

Tools Provided

Tool NameDescription
run_h3_commandRun any h3-cli command and return the output.
fetch_graphql_docsFetch GraphQL schema/docs for any query, mutation, or type.
run_graphql_requestRun a raw GraphQL query with variables and get the result.
health_checkCheck h3-cli installation and API connectivity.

See your client’s tool discovery UI for full parameter details and examples.


Usage with VS Code, Cursor, Claude Desktop, etc.

  • VS Code: Add the above config to your .vscode/mcp.json or User Settings (JSON).
  • Cursor: Add to ~/.cursor/mcp.json or your project’s .cursor/mcp.json.
  • Claude Desktop: Add to claude_desktop_config.json.
  • Windsurf: Add to your Windsurf MCP config file.

For more details, see your client’s documentation on MCP server configuration.


Troubleshooting

  • If you see errors about h3 not found, make sure you have installed and authenticated h3-cli (see below).
  • If you see authentication errors, double-check your API key in the CLI.
  • For more help, see the official h3-cli setup guide.

License

MIT License


1. Install h3-cli

git clone https://github.com/horizon3ai/h3-cli cd h3-cli bash install.sh your-api-key-here
  • Get your API key from the Horizon3.ai Portal under User → Account Settings.
  • The install script will prompt you to update your shell profile. Follow the instructions, then restart your Terminal.

2. Test your h3-cli install

h3

You should see the h3-cli help text.

3. Verify your API connection

h3 hello-world

You should see a response like:

{ "data": { "hello": "world!" } }

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

An MCP server that allows AI assistants and LLMs to interact with the Horizon3.ai API for scheduling pentests, querying results, and automating security workflows through natural language commands.

  1. What is this?
    1. Quick Copy-Paste: Add to Your MCP Client
      1. Features
        1. Tools Provided
          1. Usage with VS Code, Cursor, Claude Desktop, etc.
            1. Troubleshooting
              1. License
                1. 1. Install h3-cli
                2. 2. Test your h3-cli install
                3. 3. Verify your API connection

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that enables AI assistants to interact with Linear project management systems, allowing users to retrieve, create, and update issues, projects, and teams through natural language.
                Last updated -
                32
                80
                5
                TypeScript
                MIT License
                • Apple
              • -
                security
                A
                license
                -
                quality
                An MCP server implementation that integrates AI assistants with Langfuse workspaces, allowing models to query LLM metrics by time range.
                Last updated -
                9
                JavaScript
                Apache 2.0
              • -
                security
                A
                license
                -
                quality
                An MCP server that allows AI assistants to interact with Foundry datasets, ontology objects, and functions through natural language queries and commands.
                Last updated -
                2
                Python
                MIT License
              • A
                security
                A
                license
                A
                quality
                An MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.
                Last updated -
                11
                6
                TypeScript
                MIT License
                • Linux
                • Apple

              View all related MCP servers

              ID: jt5styg70r