IT Glue MCP Server

A Model Context Protocol server that lets AI agents on the MSPbots Agent Platform read and update IT Glue documentation: organizations, configurations, locations, passwords, documents, flexible assets, attachments and user activity metrics.

It runs as a stateless HTTP service behind the MSPbots MCP gateway. The gateway sends each tenant's IT Glue credentials as request headers on every call; the server keeps nothing between requests.

Credentials (request headers)

Header names are case-insensitive. A request to /mcp without an API key gets 401 with the list of expected headers; an invalid region or base URL gets 400.

Note: IT Glue revokes API keys that have not been used for 90 days.

Related MCP server: mcp-itglue

Tools

Tool names and parameters match the previous IT Glue connector on the MSPbots Agent Platform, so existing agents keep working. This is why the server has more than 20 tools and why most names have no itglue_ prefix.

Behaviour notes:

• Every tool returns a JSON string. Errors use one envelope: {"error": {"code": "...", "message": "...", "retryable": false}} with code one of not_configured, unauthorized, not_found, invalid_argument, rate_limited, upstream_error.

• List tools return {"items", "count", "page_number", "page_size", "has_more", "total_count"}. page_size defaults to 50 and is capped at 200. Results larger than 20,000 characters are cut and flagged with truncated / has_more.

• search_passwords never returns secrets. create_password and update_password do not echo them.

• IT Glue has no server-side name filter for documents or folders and no username filter for passwords; those filters are applied to the returned page.

• Section edits are only visible after publish_document.

• Transient failures (429, 5xx, timeouts) are retried with backoff, honouring Retry-After.

Run locally

uv sync
uv run itglue-mcp            # listens on 0.0.0.0:8080
curl -s http://127.0.0.1:8080/health
curl -s http://127.0.0.1:8080/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H "X-ITGlue-API-Key: $ITGLUE_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Environment variables (all optional): MCP_HTTP_HOST (default 0.0.0.0), MCP_HTTP_PORT (default 8080), MCP_TRANSPORT (http or stdio). Unknown variables are ignored. Credentials are never read from the environment.

Docker

docker build -t itglue-mcp .
docker run --rm -p 8080:8080 itglue-mcp

Development

uv sync
uv run pytest -q
uv run ruff check .

Code is in src/itglue_mcp/ (one module per area under tools/), tests in tests/. The implementation follows the public IT Glue API documentation at https://api.itglue.com/developer/.

License

Copyright 2026 MSPbots.ai. Licensed under the Apache License, Version 2.0. See LICENSE and NOTICE.

IT Glue is a trademark of its owner. This project is not affiliated with or endorsed by IT Glue.