GodzillaDancer keitaro mcp

MCP server for integration with Keitaro TDS API, providing tools to work with campaigns, streams, offers, and other Keitaro entities.

1. Clone the repository

git clone <repository-url>
cd mcp-keitaro-tds

1. Install dependencies

npm install

1. Install the package globally

npm install -g .

1. Install the plugin in Cursor

node install-cursor-plugin.js

1. Restart Cursor

You can also manually add the Keitaro MCP server to your Cursor configuration:

1. Open the Cursor MCP configuration file:

# On macOS
open ~/.cursor/mcp.json

# On Windows
notepad %USERPROFILE%\.cursor\mcp.json

# On Linux
nano ~/.cursor/mcp.json

1. Add the following entry to the "mcpServers" object:

"Keitaro": {
  "command": "mcp-keitaro-tds",
  "args": []
}

1. Save the file and restart Cursor

Create an .env file in the project root with the following parameters:

KEITARO_API_URL=http://your-keitaro-domain.com/admin_api/v1
KEITARO_API_KEY=your-api-key

1. Launch Cursor
2. Open the command palette (Cmd+P on macOS or Ctrl+P on Windows/Linux)
3. Find "Keitaro" and select it
4. Now you can use the Keitaro API through Cursor

• list_campaigns - get a list of campaigns
• get_campaign - get information about a specific campaign
• create_campaign - create a new campaign
• update_campaign - update an existing campaign
• delete_campaign - delete a campaign

• list_streams - get a list of traffic streams for a campaign
• get_stream - get information about a specific stream

• list_traffic_sources - get a list of traffic sources
• get_traffic_source - get information about a specific traffic source

• list_offers - get a list of offers
• get_offer - get information about a specific offer

• list_clicks - get a list of clicks
• get_click - get information about a specific click
• list_conversions - get a list of conversions
• get_conversion - get information about a specific conversion

• get_report - generate a report with specified parameters

• list_domains - get a list of domains
• get_domain - get information about a specific domain

list_campaigns({
  limit: 10,
  page: 1,
  search: "search query"
})

create_campaign({
  name: "New Campaign",
  type: "position",
  cost_type: "CPC",
  cost_value: 1.5,
  group_id: 1,
  state: "active",
  traffic_source_id: 1
})

get_report({
  from: "2025-01-01",
  to: "2025-01-31",
  group: "campaign",
  filters: {
    campaign_id: 123
  }
})

npm run dev

npm run inspect