datagate-mcp

MCP server and CLI for the DataGate billing platform API.

• MCP server — read-only tools for Claude Desktop, Claude Code, and other MCP clients
• CLI — full CRUD for managing customers, invoices, products, agreements, sites, and payments

Install

pip install datagate-mcp

Or run the MCP server directly:

uvx datagate-mcp

Configuration

Set two environment variables:

Variable	Description
DATAGATE_API_KEY	Bearer token from DataGate portal
DATAGATE_CLIENT_ID	Integration GUID from DataGate portal
DATAGATE_BASE_URL	(optional) Override base URL (default: https://api.dgportal.net)

MCP Setup

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "datagate": {
      "command": "uvx",
      "args": ["datagate-mcp"],
      "env": {
        "DATAGATE_API_KEY": "your-api-key",
        "DATAGATE_CLIENT_ID": "your-client-id"
      }
    }
  }
}

Claude Code

Add to .mcp.json:

{
  "mcpServers": {
    "datagate": {
      "command": "uvx",
      "args": ["datagate-mcp"],
      "env": {
        "DATAGATE_API_KEY": "your-api-key",
        "DATAGATE_CLIENT_ID": "your-client-id"
      }
    }
  }
}

CLI Usage

# List customers
datagate customers list
datagate customers list --page 2 --page-size 25

# Get a customer
datagate customers get <customer-id>

# Search invoices
datagate invoices search --invoice-date 2026-01-01
datagate invoices search --period-start 2025-12-01 --period-end 2025-12-31

# Invoice line items
datagate invoices details <invoice-id>

# List products (optionally by customer)
datagate products list --customer-id <id>

# JSON output
datagate --json customers list

Write Operations

All write commands require --confirm:

datagate customers create --name "Acme Corp" --code "50099"
datagate customers update <id> --data '{"companyName": "Acme Corp LLC"}'
datagate customers delete <id> --confirm

datagate products create --customer-id <id> --code "Internet 1Gb"
datagate sites create --customer-id <id> --name "123 Main St"

# Payments are IRREVERSIBLE — void only via DataGate portal
datagate payments create --customer-id <id> --amount 100.00 --confirm

MCP Tools

Tool	Description
list_customers	List customers with pagination
get_customer	Get single customer by ID
search_invoices	Search invoices by date/period
get_invoice_details	Invoice with line-item transactions
list_products	Products with pricing, filterable by customer
get_product	Single product with charges
list_agreements	Billing agreements, filterable by customer
get_agreement	Single agreement
list_sites	Physical locations, filterable by customer
list_customer_users	Portal login accounts
list_service_items	Service items
list_rate_cards	Rate cards
list_kit_templates	Kit templates

Rate Limits

• 60 calls/minute
• 5,000 calls/day
• The client automatically paces requests to stay within limits.

License

MIT