Skip to content

MCP server (for AI agents)

A growing share of integrators are AI agents. InterGlobe ships an official Model Context Protocol server so an agent (Claude Desktop, an IDE, or any MCP client) can provision and manage eSIMs directly. It’s backed by the TypeScript SDK.

The server speaks MCP over stdio and reads credentials from the environment:

  • IG_API_KEY (required) — use an ig_test_ sandbox key: the write tools create and mutate real eSIMs.
  • IG_API_URL (optional) — override the base URL (defaults per the key prefix).
Terminal window
IG_API_KEY=ig_test_… npx @interglobe/mcp
{
"mcpServers": {
"interglobe": {
"command": "npx",
"args": ["-y", "@interglobe/mcp"],
"env": { "IG_API_KEY": "ig_test_your_sandbox_key" }
}
}
}

Reads (read-only): get_me, get_wallet, list_usage, list_products, get_product, list_coverage, get_coverage, list_esims, get_esim, get_esim_status, get_esim_usage, list_bundles.

Writes: provision_esim, assign_bundle, suspend_esim, resume_esim, and terminate_esim (marked destructive — it is permanent). Errors are returned as structured tool errors carrying the InterGlobe error code.