# Gigs MCP > Gigs connects your telecom-as-a-service account directly into your AI agent, letting you manage mobile connectivity workflows without logging into a portal. Use this MCP to check data usage in real time, list all active subscriptions and SIM cards, or even create brand new plans across 200+ countries—all through natural conversation. ## Overview - **Category:** cloud-infrastructure - **Price:** Free - **Tags:** esim, mobile-plans, connectivity, telecom-as-a-service, subscriber-management ## Description This MCP connects the Gigs telecom account to your AI agent, handling complex mobile connectivity tasks instantly. Forget digging through carrier dashboards just to check a customer's data usage or verify an eSIM activation. You can ask your agent things like, 'What plans are available for Kenya?' and get back a list of options, or 'List every active user profile.' It pulls real-time billing and account details into your chat window. By connecting through Vinkius, you give your AI client access to the entire catalog, making it one place for all your telecom operations. You can automatically set up new mobile subscriptions using existing plan IDs, manage thousands of users, or check project settings without ever leaving your primary workspace. ## Tools ### verify_api_connection Confirms that your AI agent has proper access credentials to Gigs. ### create_mobile_subscription Sets up a new mobile service plan for a user using an existing plan ID. ### create_telecom_user Adds a completely new customer profile to the Gigs system. ### get_account_details Retrieves high-level identity and configuration details for your connected Gigs account. ### get_plan_details Looks up the full technical metadata and features of a specific mobile plan ID. ### get_subscription_details Fetches all associated metadata for an existing, active subscription. ### get_subscription_usage Reports the current data, talk, and text usage figures for a specific account. ### list_connectivity_plans Generates a comprehensive list of all available voice and data plans globally. ### list_telecom_projects Retrieves project metadata to verify specific settings within your Gigs account setup. ### list_connectivity_sims Lists all physical and digital SIM cards associated with the account, along with their details. ### list_mobile_subscriptions Generates a list of every currently active or inactive mobile subscription record. ### list_connectivity_users Lists all registered user profiles and their associated account details. ## Prompt Examples **Prompt:** ``` List all available mobile data plans in the catalog. ``` **Response:** ``` Retrieving plans... I found 15 available plans, including 'USA 5GB Data' (ID: plan_123) and 'Global Unlimited Talk & Text'. Would you like the pricing details for any of them? ``` **Prompt:** ``` How much data has user 'sub_98765' used this month? ``` **Response:** ``` Checking usage... User sub_98765 has consumed 2.4 GB of their 5 GB data cap. They have also used 45 minutes of talk time and sent 12 text messages. ``` **Prompt:** ``` Create a new subscription for 'john@example.com' using plan 'plan_abc'. ``` **Response:** ``` Subscription created! I have successfully attached plan plan_abc to user john@example.com. The new Subscription ID is 'sub_555' and the eSIM is ready for activation. ``` ## Capabilities ### Track real-time data consumption Check current talk time and data usage for any user's active subscription. ### Manage all mobile subscriptions List, view details, or create new connectivity plans instantly. ### Add and manage users Programmatically register new telecom accounts and update their profile information. ### Discover global plans Access a catalog of voice and data plans available across over 200 countries. ### Verify hardware inventory List metadata for both physical SIM cards and modern eSIMs. ## Use Cases ### Auditing dormant accounts An Ops Engineer needs to see which users haven't used service in the last 90 days. They ask their agent to run `list_mobile_subscriptions` and filter the results by inactivity date, getting a clean list of candidates for deactivation. ### Quick plan comparison A Product Manager is debating pricing tiers in Africa. They simply prompt the agent with 'Show me all data plans for Nigeria' and use `list_connectivity_plans` to pull a structured list of regional options. ### Onboarding new clients A Customer Support Agent helps a client move service. They first run `create_telecom_user`, then prompt the agent to select a plan using `list_connectivity_plans`, and finally execute `create_mobile_subscription` in one conversational thread. ### Verifying account ownership A Billing Specialist needs confirmation that an old client still exists. Running `get_account_details` provides the necessary identity verification data without needing credentials or manual lookups. ## Benefits - Check a customer's consumption history instantly. Using `get_subscription_usage` lets you report back exactly how much talk time or data they’ve used this month without opening a single dashboard tab. - Build new plans on the fly. If a client needs service in a new region, you can use `list_connectivity_plans` to find viable options and then `create_mobile_subscription` to provision it right away. - Scale user management effortlessly. Instead of manually creating records, running `create_telecom_user` allows your agent to onboard new clients with just a couple of prompts. - See all hardware in one place. The `list_connectivity_sims` tool lets you audit every physical and eSIM card attached to the account in seconds, solving inventory nightmares. - Diagnose issues faster than ever. If a user complains about connectivity, checking the initial connection status via `get_account_details` narrows down whether it’s an account issue or a plan limitation. ## How It Works The bottom line is that you automate complex billing and account lookups using simple chat commands. 1. Subscribe to this MCP through the Vinkius Marketplace using your Gigs Project API Key. 2. Connect your preferred AI client (Claude, Cursor, etc.) to Vinkius and authorize access with your key. 3. Ask your agent a question like 'What is the data usage for sub_123?' and it performs the necessary actions. ## Frequently Asked Questions **How do I check usage with the Gigs MCP?** You use `get_subscription_usage`. Simply tell your agent which user ID you want to check, and it reports current data consumption, talk time used, and text message counts. **Can I list all available mobile plans using Gigs MCP?** Yes, running `list_connectivity_plans` pulls a comprehensive catalog of every voice and data plan. This is essential for recommending options to clients in new regions. **What if I need to add a brand new user? Which Gigs MCP tool do I use?** Use the `create_telecom_user` tool. This function allows you to programmatically register a brand new customer profile and start their lifecycle within your system. **Does the Gigs MCP help with eSIMs?** Yes, running `list_connectivity_sims` lets you list metadata for both physical SIM cards and modern eSIM profiles, giving you a full inventory view. **What is the difference between listing subscriptions and getting details on one? (Gigs MCP)** `list_mobile_subscriptions` gives you an overview of every subscription ID. `get_subscription_details` then takes a specific ID to give deep, detailed metadata about that single plan.