How to Use the Gigs MCP in Claude

Q: How do I install Gigs on Claude Desktop?

To run Gigs on Claude Desktop, open your claudedesktopconfig.json and add the MCP server configuration under the mcpServers key. Once you restart the app, the 12 Gigs telecom tools will be ready to use in your Claude Desktop chat panel.

Q: Can Claude Desktop handle dynamic plan selection using Gigs?

Yes, Claude Desktop uses listconnectivityplans and getplandetails to search and filter available Gigs carrier profiles. Your Claude Desktop agent then selects the correct plan based on your criteria.

Q: How does Gigs help Claude Desktop track data overages?

By running getsubscriptionusage alongside listmobilesubscriptions, Claude Desktop monitors data consumption across all active Gigs SIMs. This lets your Claude Desktop agent alert you before any line hits its threshold.

Q: Do I need external scripts to manage Gigs telecom users in Claude Desktop?

No, you don't need them because Claude Desktop uses createtelecomuser to register new Gigs profiles directly through the chat, bypassing external dashboards.

Provision eSIMs and track live cellular data usage directly in Claude Desktop using the Gigs MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gigs MCP to Claude Desktop

Create your Vinkius account to connect Gigs to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Gigs with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Instantly spin up mobile plans inside Claude Desktop

The `create_mobile_subscription` tool lets Claude Desktop order and configure Gigs cellular plans directly from your chat window. You can query `list_connectivity_plans` in Claude Desktop to see what Gigs packages are available, select a package, and assign it to a telecom user profile. This Gigs setup eliminates the need to log into carrier dashboards manually while using Claude Desktop. Your Claude Desktop agent builds the Gigs payload, runs the provisioning step, and confirms the active eSIM status within seconds, which is much cleaner than dealing with slow carrier portals inside your Claude Desktop workspace.

Run automated eSIM audits with this MCP Server

The `list_connectivity_sims` tool exposes active Gigs SIM card profiles to Claude Desktop for rapid inventory checks. Running `list_connectivity_users` in Claude Desktop maps individual Gigs SIM profiles back to specific team members. If you run into connectivity issues with your Gigs carrier setup, Claude Desktop can invoke `verify_api_connection` to confirm the link. This keeps your Gigs inventory accurate inside Claude Desktop without forcing you to write custom billing scripts, because scripting this manually is a waste of time when Claude Desktop handles Gigs connections directly.

Track real-time cellular data consumption in chat

The `get_subscription_usage` tool pulls precise Gigs data consumption metrics directly into your Claude Desktop workspace. By combining this with `get_subscription_details`, your Claude Desktop agent can flag Gigs SIM cards that are getting close to their monthly limits. You get immediate visibility into active Gigs cellular costs without leaving your Claude Desktop conversation. Claude Desktop handles the Gigs API calls, processes the raw usage bytes, and presents a clean breakdown of current network consumption.

Setup guide

Set up Gigs MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Gigs MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Gigs MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under gigs-mcp.

json

{
  "mcpServers": {
    "gigs-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Gigs. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Gigs now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Gigs MCP in Claude Desktop

To run Gigs on Claude Desktop, open your `claude_desktop_config.json` and add the MCP server configuration under the `mcpServers` key. Once you restart the app, the 12 Gigs telecom tools will be ready to use in your Claude Desktop chat panel.

Yes, Claude Desktop uses `list_connectivity_plans` and `get_plan_details` to search and filter available Gigs carrier profiles. Your Claude Desktop agent then selects the correct plan based on your criteria.

By running `get_subscription_usage` alongside `list_mobile_subscriptions`, Claude Desktop monitors data consumption across all active Gigs SIMs. This lets your Claude Desktop agent alert you before any line hits its threshold.

No, you don't need them because Claude Desktop uses `create_telecom_user` to register new Gigs profiles directly through the chat, bypassing external dashboards.

This MCP integration passes Gigs SIM metadata, usage logs, and subscriber profiles through a secure local stdio transport in Claude Desktop. Vinkius keeps your API keys isolated so your raw carrier credentials never leak to the public web.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript