DataGate + AI - for Claude, ChatGPT, Codex, Cursor, and any agent that speaks MCP
Unofficial. Community-built Claude Code Skill and MCP server for the DataGate telecom billing API. Not affiliated with, endorsed by, or sponsored by DataGate. DataGate is a trademark of its respective owner.
Add DataGate customer, agreement, and invoice lookups to the AI you already use -
Claude Code, Claude Desktop, ChatGPT (desktop app), Codex, Cursor,
Windsurf, Cline, Continue, Gemini, or GitHub Copilot. Free, open
source, runs on your laptop. A local SQLite mirror means repeated lookups don't have
to page through the live API by hand, and don't eat into DataGate's per-account rate
limit. Built for MSPs and telecom resellers who bill through DataGate. No code
required.
Works with your agent
Security note (until this connector is reprinted). Do not run HTTP mode
(--transport http), not even on localhost. This build checks a token, but it
predates the fix release's request size and time limits. The MCP tools can
also make changes with your credentials. Use the default stdio transport. If
you set up a tunnel for a remote agent, shut it down. A fix is on the way.
| Your AI agent | How to install the DataGate skill |
|---|
| Claude Desktop | Run installer, then Settings > Extensions to register datagate-mcp (no JSON editing). |
| ChatGPT (desktop app) | Run installer, then add datagate-mcp in Settings > MCP servers as a local (STDIO) server. ChatGPT on the web is not supported yet. |
| Claude Code | Paste the install prompt below. |
| Codex CLI | Paste the install prompt below. |
The ChatGPT desktop app runs datagate-mcp locally and shares MCP configuration with Codex (OpenAI). ChatGPT on the web needs a remote (HTTP) server, and this connector's HTTP mode is paused until it is reprinted (see the security note in mcp-install.md), so msp-skills does not support it yet. If your team works there, a hosted gateway is the better pick; check that your AI app is on the gateway's setup list.
Also works with Cursor, Windsurf, Cline, Continue.dev, Zed, GitHub Copilot, and
Gemini CLI - plus any MCP-speaking agent, via MCP and the pre-wired skill
frontmatter. Full per-tool wire-up: docs/which-agent.md.
Install
macOS / Linux:
bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/datagate/install.sh)
Windows (PowerShell):
iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/datagate/install.ps1 | iex
Both installers detect your OS and architecture, download the datagate-cli and
datagate-mcp binaries from this repo's Releases, write them to ~/.local/bin
(macOS/Linux) or %LOCALAPPDATA%\Programs\msp-skills\ (Windows), clear macOS
Gatekeeper quarantine, and honor DRY_RUN=1.
Authenticate
export DATAGATE_API_KEY="<your Bearer token>"
export DATAGATE_CLIENT_ID="<your ClientId GUID>"
datagate-cli doctor
Both values come from your own DataGate account - there's no OAuth flow, no token
expiry, and nothing to refresh. doctor confirms both are set and the API is
reachable.
Why a local mirror instead of a wrapper
Most thin DataGate wrappers proxy every question into a live API call. That's fine
for one customer lookup, but it adds up once you're checking a large customer list
or pulling invoices repeatedly - each call counts against DataGate's rate limit (60
requests/minute, 5,000/day, per account). This skill syncs customers, agreements,
and invoices into a local SQLite mirror with full-text search, so repeated lookups
become one local query: instant, offline, and no extra API calls.
What it covers
Read-only (list, get, search) across DataGate's resource groups: customers, customer
users, agreements, service items, assignments, rate cards, sites, product templates,
kit templates, invoices, products, delivery methods, product transactions, and
account managers. See governance.md for the full read/write
breakdown and guide.md for every command.
Example commands
datagate-cli customers list --json
datagate-cli agreements list --select id,customerId,name,status --json
datagate-cli invoices --period-start 2026-08-01T00:00:00Z --period-end 2026-08-31T23:59:59Z --json
datagate-cli sync
datagate-cli search "<customer name or invoice number>"
Known gaps
This build is read-only by design - DataGate's CRUD surface is documented but this
connector doesn't implement create/update/delete. A handful of endpoint paths
(sites, products, product templates, kit templates, delivery methods, product
transactions, account managers) were derived from DataGate's own naming convention
rather than individually confirmed against a live tenant - if you run this against
your own account and something's off, please file it (see
CONTRIBUTING.md, rung 2 - a bug report with real-tenant
evidence is worth more than one we can't reproduce).
License
Apache-2.0. See cli/LICENSE and cli/NOTICE.