How do I install Infrahub?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Infrahub need an API key?

The publisher lists these environment variables: INFRAHUB_ADDRESS, INFRAHUB_API_TOKEN.

What transport does Infrahub use?

Infrahub runs locally over stdio.

When was Infrahub last checked?

Last checked 2026-11-10. An MCP server connects your AI assistants to Infrahub using the open MCP standard.

Infrahub MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx infrahub-mcp==0.1.2

Credentials from the publisher

INFRAHUB_ADDRESS — The URL/address of your Infrahub instance
INFRAHUB_API_TOKEN — Your Infrahub API token for authentication

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1INFRAHUB_ADDRESS=<value> INFRAHUB_API_TOKEN=<secret> claude mcp add com.opsmill-infrahub-mcp -- uvx infrahub-mcp==0.1.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.opsmill-infrahub-mcp": {4      "command": "uvx",5      "args": [6        "infrahub-mcp==0.1.2"7      ],8      "env": {9        "INFRAHUB_ADDRESS": "<value>",10        "INFRAHUB_API_TOKEN": "<secret>"11      }12    }13  }14}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.2
License

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Infrahub MCP Server

Infrahub MCP Server connects AI assistants and IDE agents to Infrahub using the open Model Context Protocol standard — so agents can query, create, update, and propose changes to your infrastructure data through a consistent, audited interface. It works with any MCP-compatible client (Claude Desktop, VS Code, Cursor, CLI agents, and more) with no custom glue code required.

All writes are branch-isolated and require human approval before merging — agents never modify your default branch directly.

Installation

pip install infrahub-mcp
# or
uv pip install infrahub-mcp

Docker:

docker pull registry.opsmill.io/opsmill/infrahub-mcp:latest
# or use Docker Compose:
docker compose up -d

Quickstart

Point the server at your Infrahub instance via environment variables, then run it over the transport your client expects.

stdio (default — for Claude Desktop, VS Code, Cursor):

export INFRAHUB_ADDRESS=http://localhost:8000
export INFRAHUB_API_TOKEN=<your-token>
infrahub-mcp

Streamable HTTP (for remote clients, sidecar deployments):

infrahub-mcp --transport streamable-http --host 0.0.0.0 --port 8001

What you can do with it

Query your infrastructure data from natural language — find devices, interfaces, IP addresses, or any kind in your schema, with attribute filtering and partial-match search.
Explore your schema without leaving the conversation — the server exposes your catalog, per-kind attribute/filter maps, and the GraphQL SDL as MCP resources.
Make changes on isolated branches — writes land on an auto-created session branch (mcp/session-YYYYMMDD-<hex>); the default branch is never touched directly.
Submit changes for human review — call propose_changes to open a Proposed Change for approval before merging.
Run arbitrary GraphQL — execute any query or mutation against the Infrahub API when you need full control.

Documentation

Full documentation, including client configuration for Cursor, VS Code, Claude Desktop, and Claude Code, is available at the Infrahub MCP Server docs site.

About Infrahub

Infrahub is an open source infrastructure data management and automation platform (AGPLv3), developed by OpsMill. It gives infrastructure and network teams a unified, schema-driven source of truth — devices, topology, IP space, configuration — with built-in version control, a generator framework for automation, and native integrations with Git, Ansible, Terraform, and CI/CD pipelines.

License

Apache 2.0 — see LICENSE.