How to Use the Ko-fi MCP in Cursor

Q: How do I add the Ko-fi server to my Cursor editor?

Create a .cursor/mcp.json file in your project root. Define the Ko-fi server under the mcpServers key with your API key, then enable Agent mode in the Cursor chat.

Q: Can I use the Ko-fi tool to issue refunds inside Cursor?

No. The listtransactions tool is strictly read-only, meaning your Cursor agent can only view your transaction history and cannot modify your financial data or issue refunds.

Q: Does this Ko-fi MCP Server support filtering transactions in Cursor?

The listtransactions tool returns a structured list of recent payments. If you have hundreds of sales, your Cursor agent will paginate the results or filter them by date to keep the context window clean.

Q: Can I filter transactions by payment type?

The listtransactions tool pulls all recent events, including donations, subscriptions, and shop purchases. Your agent can then write code to filter these records by type locally.

Feed live Ko-fi transaction data straight into your Cursor agent to generate accurate, real-world code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Ko-fi MCP to Cursor

Create your Vinkius account to connect Ko-fi to Cursor 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 Ko-fi with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Generate code using real Ko-fi transaction schemas

The `list_transactions` tool feeds actual Ko-fi JSON payloads directly into your Cursor editor. This lets your agent write parsing scripts, database schemas, or webhook handlers based on real donation data instead of guessed stubs. You no longer waste time copying mock JSON from API documentation. Cursor reads the live output of `list_transactions`, allowing you to write, test, and debug your custom creator integrations in one continuous flow.

Debug your Ko-fi payment integrations in the Cursor chat

The `list_transactions` tool pulls your recent Ko-fi shop orders and tips directly into your active Cursor coding session. When a user reports a missing digital download, you ask the editor's agent to look up their email in the live transaction feed. The agent inspects the payload, flags missing fields, and helps you fix the logic in your local codebase. You debug the issue using actual production data without leaving your code editor.

Build local finance scripts using this MCP Server

The `list_transactions` tool retrieves your Ko-fi subscription and donation history to feed your local Python or Node scripts. Your Cursor agent writes the script, runs it, and feeds the live transaction data directly into your local database. This setup eliminates manual CSV exports from your creator dashboard. You build custom accounting tools that run locally, pulling fresh payment data whenever you execute the script inside your terminal.

Setup guide

Set up Ko-fi MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Ko-fi MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Ko-fi transactions." If the MCP tools are loaded correctly, Cursor will call the Ko-fi tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "ko-fi-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 Ko-fi. 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 Ko-fi 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 Ko-fi MCP in Cursor

Create a `.cursor/mcp.json` file in your project root. Define the Ko-fi server under the `mcpServers` key with your API key, then enable Agent mode in the Cursor chat.

No. The `list_transactions` tool is strictly read-only, meaning your Cursor agent can only view your transaction history and cannot modify your financial data or issue refunds.

The `list_transactions` tool returns a structured list of recent payments. If you have hundreds of sales, your Cursor agent will paginate the results or filter them by date to keep the context window clean.

The `list_transactions` tool pulls all recent events, including donations, subscriptions, and shop purchases. Your agent can then write code to filter these records by type locally.

No, your Ko-fi donation records and shop order history are processed locally in your editor. This MCP Server only passes this financial data to answer your prompts, and your API keys are stored securely in your local configuration.

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