# DingConnect MCP MCP > DingConnect connects your AI agent directly to global mobile services. It lets you check account balances, find operators in over 150 countries, and track transaction history instantly using natural language prompts. Handle top-ups and data products from anywhere. ## Overview - **Category:** finance-accounting - **Price:** Free - **Tags:** mobile-top-up, airtime-transfer, global-payments, transaction-auditing, operator-management ## Description Managing international telecom operations used to mean logging into a dozen different vendor portals just to verify service availability or check the current credit balance. This MCP changes that. It gives your AI client direct access to thousands of mobile operators worldwide, letting you manage everything—from listing available top-up products for specific countries to auditing past transactions—all through conversation. You simply ask what you need, and your agent handles the complex API calls in the background. Because Vinkius hosts this connection, you don't worry about vendor integration; you just get reliable access to global mobile services data. ## Tools ### check_mobile_service_status Verifies if mobile services are actually available for a specific country or destination. ### get_api_account_metadata Fetches metadata and configuration settings for your API account. ### get_account_credit_balance Retrieves the current credit balance assigned to your DingConnect API account. ### quick_operator_audit Generates a high-level summary showing operators and products for an entire country. ### list_supported_countries Retrieves the complete list of countries supported by DingConnect services. ### list_transaction_history Retrieves a list of recent top-up transactions, including status details. ### list_top_volume_countries Identifies countries that typically have high service availability and volume. ### list_available_topup_products Lists all top-up and data products that are currently available from a specific service provider. ### list_mobile_operators Provides a list of active mobile network operators for a given country code. ### search_topup_products Searches for specific top-up or data packages using keywords, like 'data' or 'voice'. ## Prompt Examples **Prompt:** ``` List all mobile operators available in Brazil. ``` **Response:** ``` I've found 4 operators available in Brazil via DingConnect: 'Vivo', 'Claro', 'TIM', and 'Oi'. Would you like to see the available top-up products for Vivo? ``` **Prompt:** ``` What is my current account credit balance? ``` **Response:** ``` Your current account balance is $250.45 USD. You have successfully processed 15 transactions today. Should I show you the recent transaction history? ``` **Prompt:** ``` Show me the top-up plans for operator 'Safaricom' in Kenya. ``` **Response:** ``` For Safaricom Kenya (KE), I've found several plans including '100 KES Top-up', '500MB Data Bundle', and 'International Voice Package'. Would you like the technical product keys for any of these? ``` ## Capabilities ### Check service availability Verify if a mobile network can provide service in a specific country or destination. ### Retrieve account balance Instantly check the current available credit balance for your DingConnect account. ### List global operators Search and list all mobile network providers supported in a given country. ### Find product details Get technical data on available top-up or data plans for any provider. ### Audit transactions Review detailed records of past service executions and their status. ## Use Cases ### New Market Entry: An Ops Manager needs to know if they can sell mobile services in Vietnam. They ask their agent and use `list_mobile_operators` first, then check the service status with `check_mobile_service_status`. The agent confirms availability across multiple providers before any sales collateral is written. ### Month-End Reconciliation: A Finance Analyst needs to verify total revenue for Q2. They ask their agent to run `list_transaction_history` and check the account limits using `get_account_metadata`. This provides a single, auditable source of truth for all payments. ### Customer Troubleshooting: A Tier 2 Agent has a customer complaining about data plans. Instead of guessing, they ask the agent to use `search_topup_products` with keywords like 'data bundle' and get specific plan details instantly. ### Strategic Planning: A Director needs to know where to focus sales efforts next quarter. They prompt their agent to run a quick audit across many regions using `quick_operator_audit` and see which countries offer the most variety of services. ## Benefits - Instantly verify service status. Use `check_mobile_service_status` to confirm if a destination is viable before building any workflow, saving time on dead ends. - Full financial visibility. Get your current account credit balance immediately with `get_account_credit_balance`, eliminating manual checks against spreadsheets. - Deep product research. Don't guess what sells; use `list_available_topup_products` or `search_topup_products` to pull technical details and pricing for specific regions. - Audit trail access. The `list_transaction_history` tool gives you a complete record of past services, letting finance teams reconcile accounts without digging through old logs. - Broad coverage. Use `list_mobile_operators` or `quick_operator_audit` to map out the entire telecom landscape for any country, making operational planning much faster. ## How It Works The bottom line is, you talk to your agent like talking to a person who has direct access to global telecom APIs. 1. Connect the DingConnect MCP to your AI client, then provide your API key in the developer settings. 2. Tell your agent what you need. For example: 'What are the operators available in Brazil?' 3. Your agent executes the necessary function calls and returns a structured answer based on real-time data. ## Frequently Asked Questions **How do I check the balance using get_account_credit_balance?** Just ask your agent for 'my current account credit balance.' The MCP runs `get_account_credit_balance` and gives you the exact, up-to-date figure in a single response. **What is list_mobile_operators?** This tool lists all mobile network providers active in a specific country. It's your first step when figuring out who offers services where. **Can I search for products using search_topup_products?** Yes, you use `search_topup_products` and give it keywords like 'data' or 'voice'. It pulls the specific plans that match your criteria. **Does quick_operator_audit cover everything?** It provides a high-level summary of operators and products for an entire country. If you need deep, technical details on one product, use `list_available_topup_products` instead. **What if I don't know the country code?** You can first call `list_supported_countries`. This gives you a list of every nation supported by DingConnect, so you know which codes to use next. **How do I find my required credentials or usage limits using get_api_account_metadata?** It retrieves all necessary metadata and settings for your developer account. You'll see rate limits, API keys, and general usage details right there. **Before I process a top-up, how do I use check_mobile_service_status to confirm availability?** This function confirms real-time service availability for any destination you specify. It stops failed transactions by telling your agent if mobile services are actually operational in that location first. **What specific details does list_available_topup_products provide beyond just the plan name?** It provides comprehensive technical keys, pricing, and plan specifics for a provider. This allows you to build complex product logic into your agent's workflow. **How do I get a DingConnect API Key?** Log in to your DingConnect account and navigate to the developer portal or API settings section to generate or retrieve your unique API Key. **Can the agent perform actual top-ups?** This integration currently focuses on discovering operators, products, and auditing balance and history. Executing actual financial top-ups should be managed via the DingConnect portal or specialized integration. **Does the integration show real-time exchange rates?** Yes, when retrieving product pricing, the agent provides the latest rates and currency conversions as reported by the DingConnect platform.