{
  "markdown": "<!-- mcp-name: io.github.jsgorana/ignition-mcp -->\n# ignition-mcp\n\nAn MCP (Model Context Protocol) server for Inductive Automation Ignition. It gives an AI\nassistant, Claude Desktop, Claude Code, or any [MCP client](https://modelcontextprotocol.io),\nstructured access to an Ignition gateway: browse and write tags, query history and alarms,\nmanage projects, and deploy full Perspective views.\n\nTested against Ignition 8.3. 43 tools spanning tags, history, alarms, projects, gateway\nadministration, and Perspective. The server is read-only by default; every write is gated behind\nan explicit opt-in.\n\n```\nYou:    \"Deploy a Perspective dashboard to a new project called LineOverview with a\n         gauge bound to [default]Line1/Speed.\"\nClaude: (bootstraps the project, writes the view, wires the tag binding, triggers a scan)\n        -> https://gateway:8088/data/perspective/client/LineOverview\n```\n\n## Why two planes\n\nIgnition 8.3 ships a native REST API, but it doesn't expose live tag values, tag history, alarm\nqueries, or Perspective view resources. `ignition-mcp` covers the gap with two transport planes:\n\n- **REST plane.** The gateway's native `/data/api/v1` API, authenticated with an API key, used\n  for projects, gateway configuration, modules, logs, backups, and Perspective session\n  diagnostics.\n- **Bridge plane.** A small WebDev project (`mcp-bridge`) you install once on the gateway. It\n  exposes the gateway scripting surface (`system.tag.*`, `system.alarm.*`, `system.db.*`, and\n  project file I/O) over HMAC-signed HTTP requests.\n\nTools that need the bridge degrade with a clear message if it isn't installed. Run\n`ignition_diagnose` any time to see what's configured and what's missing.\n\n## Quickstart\n\n### 1. Create an API key on the gateway\n\nGateway web UI -> Config -> Security -> API Keys -> Create. Give it a name, for example `claude`.\nCopy the full token; it looks like `claude:AbCd...`.\n\nThe key's auto-created security level (`Authenticated/<key-name>`) needs to be granted gateway\nread/write access under Config -> Security -> General -> Gateway Read/Write Permissions. Skip\nthis step and calls return HTTP 403; `ignition_diagnose` will tell you and give the exact fix.\n\n### 2. Install ignition-mcp\n\n```bash\npipx install ignition-mcp\n# or: uvx ignition-mcp\n# or: pip install ignition-mcp\n```\n\n### 3. Configure your MCP client\n\nClaude Desktop (`claude_desktop_config.json`) or Claude Code (`.mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"ignition\": {\n      \"command\": \"ignition-mcp\",\n      \"env\": {\n        \"IGNITION_URL\": \"http://localhost:8088\",\n        \"IGNITION_API_TOKEN\": \"claude:YOUR_SECRET_HERE\"\n      }\n    }\n  }\n}\n```\n\nRestart the client and ask it to run `ignition_diagnose`. You should get an all-green checklist,\naside from a warning about the bridge, which is the next step.\n\n### 4. Install the bridge (recommended, needed for live data and Perspective deploys)\n\nGenerate a random secret, enable writes, and let the server install the bridge for you:\n\n```json\n\"env\": {\n  \"IGNITION_URL\": \"http://localhost:8088\",\n  \"IGNITION_API_TOKEN\": \"claude:YOUR_SECRET_HERE\",\n  \"IGNITION_BRIDGE_SECRET\": \"a-long-random-string\",\n  \"IGNITION_ALLOW_WRITES\": \"true\"\n}\n```\n\nAsk your assistant to install the bridge (this runs the `bridge_install` tool), then run\n`ignition_diagnose` again to confirm the bridge check is green. See\n[docs/bridge.md](docs/bridge.md) for the manual install path and troubleshooting.\n\n## Configuration\n\n| Variable | Required | Default | Meaning |\n|---|---|---|---|\n| `IGNITION_URL` | yes | none | Gateway base URL, e.g. `http://localhost:8088` |\n| `IGNITION_API_TOKEN` | yes | none | API key, `name:secret` |\n| `IGNITION_BRIDGE_SECRET` | no | unset | HMAC secret for the bridge; bridge tools are disabled without it |\n| `IGNITION_ALLOW_WRITES` | no | `false` | Master switch for every mutating tool |\n| `IGNITION_TLS_VERIFY` | no | `true` | Set to `false` for self-signed dev gateways |\n| `IGNITION_TIMEOUT_S` | no | `30` | Per-request timeout, in seconds |\n| `IGNITION_TAG_WRITE_ALLOWLIST` | no | unset | Comma-separated glob patterns; tag writes outside them are refused |\n\n## Safety model\n\n- Read-only by default. Mutating tools refuse to run unless `IGNITION_ALLOW_WRITES=true` and the\n  call passes `confirm=true`. Your assistant sets `confirm` after you approve the action.\n- Destructive operations echo the name back. Deleting a project or view requires re-sending its\n  exact name.\n- A tag-write allowlist lets you restrict writable tags to specific path globs.\n- REST mutations carry the API key's identity into Ignition's own audit log; bridge mutations log\n  to the `mcp-bridge` logger. Secrets are never logged or echoed back.\n- The bridge's file endpoints are confined to `data/projects/`; nothing outside that tree is\n  reachable.\n\n## Tool catalog\n\n| Area | Tools |\n|---|---|\n| Diagnostics | `ignition_diagnose`, `gateway_info`, `gateway_trial_status`, `gateway_trial_reset` |\n| Tags | `tag_browse`, `tag_read`, `tag_write`, `tag_create`, `tag_config_export`, `tag_config_import` |\n| History | `history_query`, `history_providers` |\n| Alarms | `alarm_status`, `alarm_journal`, `alarm_acknowledge` |\n| Projects | `project_list`, `project_get`, `project_create`, `project_delete`, `project_export`, `project_import`, `project_scan` |\n| Perspective | `perspective_bootstrap_project`, `perspective_list_views`, `perspective_get_view`, `perspective_upsert_view`, `perspective_delete_view`, `perspective_validate_view`, `perspective_page_config_get/set`, `perspective_session_props_get`, `perspective_style_upsert`, `perspective_list_sessions` |\n| Gateway admin | `gateway_modules`, `gateway_logs_query`, `gateway_logger_set_level`, `gateway_backup`, `gateway_performance`, `config_resource_list` |\n| Database | `db_run_named_query`, `db_query` |\n| Bridge | `bridge_install`, `bridge_status` |\n\nThe server also exposes MCP resources the assistant can read to author valid Perspective views:\n`ignition://docs/view-schema` and `ignition://templates/view/{flex-basic,coordinate-basic,tag-bound-dashboard}`.\n\n## Building Perspective views\n\nSee [docs/perspective-authoring.md](docs/perspective-authoring.md) for the full writeup. In\nshort: the assistant reads the view-schema resource, starts from a template, validates offline\nwith `perspective_validate_view`, then deploys with `perspective_upsert_view`, which validates\nagain, writes the view, and triggers a project scan. A full round-trip example is in\n[examples/deploy-dashboard.md](examples/deploy-dashboard.md).\n\n## Development\n\n```bash\ngit clone https://github.com/jsgorana/ignition-mcp\ncd ignition-mcp\npython -m venv .venv && source .venv/bin/activate\npip install -e \".[dev]\"\n\nruff check src tests          # lint\nruff format --check src tests # format check\nmypy src                      # type check\npytest tests/unit             # unit tests, no gateway needed\npython bridge/build_zip.py    # rebuild the bridge project archive\n\n# Live integration suite (needs a real 8.3 gateway with the bridge installed):\nIGNITION_URL=... IGNITION_API_TOKEN=... IGNITION_BRIDGE_SECRET=... \\\nIGNITION_ALLOW_WRITES=true python tests/live/live_check.py\n```\n\n## Acknowledgments\n\nBuilt on the [Model Context Protocol](https://modelcontextprotocol.io) and its\n[Python SDK](https://github.com/modelcontextprotocol/python-sdk), using\n[httpx](https://www.python-httpx.org/) for HTTP. The\n[ignition-sdk-examples](https://github.com/inductiveautomation/ignition-sdk-examples) repository\nwas a useful reference while working out how Ignition's module and scripting APIs fit together.\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n\n## Disclaimer\n\nThis project is independent and community-built. It is not affiliated with, endorsed by, or\nsponsored by Inductive Automation. \"Ignition\" and \"Perspective\" are trademarks of Inductive\nAutomation, LLC, used here only to describe compatibility. Test any write-enabled tool against a\nnon-production gateway before pointing it at something that matters.\n",
  "bytes": 7986,
  "sha": "10903217228737aff9d429eee38741bd7196bd5e66873ef78439a6a5ddba57fe",
  "repo_slug": "jsgorana/ignition-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jsgorana_ignition_mcp_05f6e416/readme"
}