# Ko-fi MCP > Ko-fi MCP monitors all your creator income sources—donations, subscriptions, and shop orders. Connect it to any AI agent to track every transaction or message without having to log into a dashboard. It gives you real-time visibility into your funding and supporter interactions. ## Overview - **Category:** finance-accounting - **Price:** Free - **Tags:** donations, creator-economy, crowdfunding, transactions, support ## Description Your AI client treats this connection like a personal business assistant for your creative work. Instead of manually checking the Ko-fi website to see if someone tipped you or placed an order, you just ask your agent. The MCP polls the Ko-fi API, pulling in all your recent activity—one-time tips, recurring monthly subscriptions, and shop sales. You get a clean summary right where you are working, whether that's in your code editor or chat window. This eliminates dashboard hopping. With Vinkius, this MCP lets you keep track of every dollar coming in, instantly seeing the messages attached to those payments so you can respond to fans faster. It’s all available through natural conversation. ## Tools ### list_transactions Retrieves a list of all recent Ko-fi transactions, detailing donations, subscriptions, and shop sales. ## Prompt Examples **Prompt:** ``` List my recent Ko-fi transactions. ``` **Response:** ``` I've retrieved your latest Ko-fi activity. You have 3 new donations totaling $45.00 and one new shop order for a 'Digital Art Print'. Would you like to see the messages attached to these donations? ``` **Prompt:** ``` Check if I received any new subscriptions on Ko-fi today. ``` **Response:** ``` Checking your transactions... Yes, you received one new monthly subscription from 'Alex_Dev' for $5.00. This brings your total active subscribers to 12. ``` **Prompt:** ``` Show me the latest messages from my Ko-fi supporters. ``` **Response:** ``` Here are the latest messages: 'Keep up the great work!' from Sarah ($10) and 'Love the new tutorial!' from Mike ($5). Would you like me to summarize all feedback from this week? ``` ## Capabilities ### Monitor financial activity The agent checks for and reports on all recent payments, including both donations and shop purchases. ### Track recurring revenue You can get details on active subscriptions and monthly payouts from your supporters. ### Review supporter communications The connection pulls in the latest messages, allowing you to see community feedback alongside financial data. ## Use Cases ### Artist Needs Quarterly Income Report An artist needs to prepare a report showing their earnings over the last three months. Instead of downloading multiple CSVs, they ask their agent to run `list_transactions` for the specific date range, getting structured data instantly. ### Streamer Needs Quick Status Check A streamer is coding and gets distracted by a donation alert. Instead of switching tabs, they tell their AI agent to check recent activity, getting a quick summary of tips and subs without losing their flow. ### Maintainer Tracks Sponsorships An open-source maintainer needs to confirm if a sponsor paid on schedule. They query the MCP for transactions; the agent runs `list_transactions` and confirms the payment amount and date immediately. ## Benefits - Never manually check your dashboard again. Your AI agent uses `list_transactions` to fetch all recent financial data instantly when you ask for it. - Keep track of recurring income streams by checking subscription details alongside one-time tips in a single conversation thread. - Get immediate visibility into supporter feedback. You see the latest messages from your community right after seeing their payment attached. - It organizes complex finance data. Instead of wading through multiple Ko-fi pages, you get a clean summary covering donations, subscriptions, and shop orders. - Use this MCP to build reporting loops. Your agent can pull all transaction data and summarize it for quarterly reports on demand. ## How It Works The bottom line is that your AI client acts as an API wrapper, executing the necessary checks so you don't have to. 1. Subscribe to this MCP and enter your Ko-fi API Key into Vinkius. 2. Connect your preferred AI client (like Cursor or Claude) to the Vinkius catalog. 3. Ask your agent a question, such as 'What was my activity today?' The agent then calls `list_transactions` and gives you a summary. ## Frequently Asked Questions **Can I see recent donations and messages from my supporters?** Yes! By using the `list_transactions` tool, your agent will fetch the most recent activity, including the supporter's name, the amount donated, and any message they left for you. **Does this tool include shop orders and commissions?** Yes, the `list_transactions` tool polls the Ko-fi API for all types of transactions, which includes donations, recurring subscriptions, and shop orders. **Can I send messages or replies back to supporters through this integration?** No. The current version of the Ko-fi MCP server is focused on querying and monitoring data using the `list_transactions` tool. It does not currently support write operations or sending messages. **How do I get started with the Ko-fi MCP using my API key?** You connect by subscribing to this MCP and entering your personal Ko-fi API Key. Your AI agent then uses that key to poll the necessary data endpoints automatically. This process keeps you connected without needing manual configuration changes. **What happens if I call list_transactions too often?** The MCP respects the official Ko-fi API rate limits. If your agent makes too many requests in a short period, the system will pause and wait for the required cooldown time. You won't accidentally overload the connection. **Does list_transactions show details on recurring subscriptions?** Yes, it captures more than just one-time donations. When you run list_transactions, your agent sees both initial donation amounts and active subscription statuses, helping you track steady revenue streams. **How secure is my financial data when using the Ko-fi MCP?** Your connection uses standard API security protocols. The sensitive data remains managed within your private AI client environment; we never store or expose raw credentials outside of that secured context. **Can I use this Ko-fi MCP with my custom agent workflow?** Absolutely. Because it adheres to the Model Context Protocol, you can connect it to virtually any compatible AI client or customized agent setup. It just needs that standard API key.