# Tingg Insights MCP > Tingg Insights MCP Server connects your Tingg payments account directly to any AI client. You can manage disbursements, track bank settlements, and monitor payment activity across African markets using simple chat commands. It lets you programmatically initiate payouts, check transaction statuses in real-time, and pull high-level performance metrics for immediate financial oversight. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** african-payments, payment-gateway, mobile-money, disbursements, fintech-api, tingg ## Description **Tingg Insights MCP Server** connects your Tingg payments account directly to your AI client. You use this server to manage everything from collecting funds in African markets to tracking bank settlements—all through simple chat commands. It gives you programmatic control over disbursements and real-time visibility into payment flow. ### System Health & Setup You can check the connection status with `check_api_health`; it confirms if your link to the Tingg API is active and running right. If you need to see what webhooks are set up for your account, `list_configured_webhooks` displays that list immediately. For maintenance checks, you'll also use `list_account_settlements`, which shows every record of bank settlements, letting you know exactly when funds move from Tingg into your local bank account. ### Tracking Incoming Payments (Inflow) When a customer needs to pay, you start the process by using `create_checkout_request`; this kicks off a new payment collection request for them through various methods. If you need to know if that specific transaction went through and what its current status is, run `get_transaction_status` with one unique ID. To get a log of recent activity—good or bad—you pull the full feed using `list_payment_transactions`, which shows all transactions including failures. For high-level oversight, you retrieve key metrics about your account, like total volume and success rates over time, with `get_account_performance_metrics`. If you need to reverse a recent charge or refund an item, `initiate_payment_refund` submits the request for that specific checkout or sale. ### Managing Outgoing Funds (Outflow) Sending money out is straightforward. To start the transfer process and send funds to any recipient, use `initiate_payout_request`. If you need to know how much money has already been sent or tracked, you can look at two lists: `list_disbursement_payouts` provides a complete ledger of every payout you've started or monitored. For the status of one particular disbursement, run `get_payout_status`; it tells you exactly where that specific payout stands right now. These tools let you handle both B2C and B2B payouts across supported mobile money channels or banks. ### Communication & Logging You don't just track numbers; you gotta talk to people too. You can send automated messages—either transactional SMS alerts or email notifications—to users using `send_engagement_notification`. If you need a complete overview of all the payouts and disbursements you've ever initiated, check out the full list with `list_disbursement_payouts` again for comprehensive record-keeping. Essentially, this server lets your AI client manage everything from initial payment requests to final bank settlements and ongoing user communication without leaving the chat window. ## Tools ### check_api_health Verifies if the connection to the Tingg API is active and working correctly. ### create_checkout_request Starts a new payment collection process for a customer using various methods. ### get_account_performance_metrics Retrieves key metrics about your account, such as total volume and success rates over time. ### get_payout_status Checks the current status of a specific payout or disbursement record. ### get_transaction_status Retrieves the real-time status for one unique payment transaction ID. ### initiate_payout_request Starts the money transfer process, sending funds out to a recipient. ### list_disbursement_payouts Shows a complete list of all payouts and disbursements you've initiated or tracked. ### list_account_settlements Lists all records of bank settlements showing when funds move into your local bank account. ### list_payment_transactions Fetches a recent log of payment transactions, including successes and failures. ### list_configured_webhooks Displays the list of active webhooks configured for your Tingg account. ### send_engagement_notification Sends automated transactional messages via SMS or email alerts to users. ### initiate_payment_refund Submits a request to process a refund against a recent checkout or sale. ## Prompt Examples **Prompt:** ``` List the last 5 payment transactions in my Tingg account. ``` **Response:** ``` I've retrieved your recent transactions. You have 5 checkout requests including #TX-8823 (Success), #TX-8824 (Pending), and #TX-8825 (Failed). Would you like real-time status for the pending request? ``` **Prompt:** ``` Show me my account performance metrics. ``` **Response:** ``` Fetching performance stats... Your account shows a 94% payment success rate over the last 30 days. Total volume processed is $12,500 across mobile money and card channels. Shall I break this down by country? ``` **Prompt:** ``` Check the status of payout 'payout_10293'. ``` **Response:** ``` Retrieving payout info... Payout payout_10293 is currently 'Processed Successfully'. The funds have been sent to the recipient's mobile money wallet. Is there anything else you'd like to track? ``` ## Capabilities ### Check Account Health Verifies the current connection status of the Tingg API. ### Request Payment Creates a new checkout request to collect funds through various payment methods. ### Get Performance Stats Pulls high-level account metrics, like total volume and success rates. ### Check Payout Status Retrieves the current status of a previously initiated payout or disbursement. ### Get Transaction Status Checks the real-time status for one specific payment transaction ID. ### Initiate Refund Sends a request to process a refund against a completed payment. ### Send Money Out Starts the process of sending funds (payout) to a specific recipient or group. ## Use Cases ### Reconciling a Missing Payout A business owner notices a payout is missing. They ask their agent to first run `list_disbursement_payouts` to find the record, then use `get_payout_status` with the ID. The agent confirms it's 'Pending' and advises on next steps. ### Auditing Failed Payments The finance team needs to check why a customer payment failed last week. They run `list_payment_transactions` to pull the list, locate the specific ID, and then use `get_transaction_status` for real-time details. ### End of Month Financial Review The ops manager needs a summary. They ask the agent to retrieve account performance data using `get_account_performance_metrics`, and then cross-reference it with bank deposits by calling `list_account_settlements`. ### Handling a Payment Failure A payment fails, but the customer needs to know. Instead of sending an email manually, the agent runs `initiate_refund` (if appropriate) and then sends a follow-up alert using `send_engagement_notification`. ## Benefits - Stop guessing where your money is. By using `list_account_settlements`, you get a clear record of funds moving from Tingg into your local bank account, simplifying reconciliation immediately. - No more manual status checks. Instead of logging into separate dashboards, simply ask the agent to run `get_payout_status` or `get_transaction_status` and get an immediate answer. - Automate customer communication. Use `send_engagement_notification` to trigger necessary SMS or email alerts when a payment is successful or a payout fails. - Get a full picture of your health. The `get_account_performance_metrics` tool pulls aggregate data, giving you success rates and total volumes without running complex reports. - Control outgoing funds. You can programmatically send money to recipients using `initiate_payout_request`, controlling the entire disbursement lifecycle in one place. ## How It Works The bottom line is: your AI agent runs the code; you just ask questions about your money. 1. Subscribe to this server and enter your Tingg Client ID and Client Secret from your merchant portal. 2. Direct your AI agent (Claude, Cursor, etc.) to the MCP endpoint. The agent authenticates using the credentials you provided. 3. Use natural conversation to invoke specific tools, like asking 'What's the status of payout X?' or 'List my last 5 transactions.' You get real-time financial data back from Tingg. ## Frequently Asked Questions **Can I check the status of a specific payment request via AI?** Yes! Use the `get_transaction_status` tool and provide the Checkout Request ID. Your agent will retrieve the real-time payment status from Tingg. **How do I see my latest bank settlements?** Run the `list_account_settlements` query. The agent will retrieve a list of all funds that have been settled from your Tingg account to your linked bank account. **Is it possible to send money to a recipient (payout) via AI?** Absolutely. Use the `initiate_payout_request` action. Provide the payout details including amount, currency, and recipient info in the JSON payload to start the disbursement. **How do I use the `check_api_health` tool to verify Tingg API connectivity?** It quickly confirms that your AI client can reach the Tingg API. This is a good first step before running any financial commands, ensuring everything is connected and ready to go. **What steps are needed to process a refund using the `initiate_payment_refund` tool?** You must provide the specific transaction ID and the exact amount for the refund. The AI will submit this request, initiating the reversal process through Tingg. **Can the AI use `send_engagement_notification` to send SMS or Email alerts?** Yes, you can trigger user notifications via this tool. Just tell your agent who needs the alert and what the message content should be; it handles both SMS and email channels. **How do I retrieve key business data using the `get_account_performance_metrics` tool?** This tool pulls aggregated performance statistics. You get high-level numbers—like total volume or payment success rates—over a chosen time period, giving you a quick view of business health. **Which tool do I use to view active webhooks with `list_configured_webhooks`?** The `list_configured_webhooks` tool shows all the endpoints currently set up on your account. This lets you verify which external systems are automatically triggered by Tingg events.