Keitaro MCP

🚀 Keitaro TDS API MCP Plugin

This MCP server is designed to integrate with the Keitaro T T TDS API, offering tools for handling campaigns, streams, offers, and other Keitaro entities.

🚀 Quick Start

This plugin enables seamless integration with the Keitaro TDS API within the Cursor environment. It provides a suite of tools to manage various Keitaro entities efficiently.

📦 Installation

Installing the Plugin in Cursor

1. Clone the repository

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

2. Install dependencies

npm install

3. Install the package globally

npm install -g .

4. Install the plugin in Cursor

node install-cursor-plugin.js

5. Restart Cursor

Alternative: Manual Configuration in Cursor

You can also directly 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

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

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

3. Save the file and restart Cursor

API Key Configuration

Create a .env file in the project root directory and add the following parameters:

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

💻 Usage Examples

Using Keitaro API in Cursor

1. Launch Cursor
2. Open the command palette (Cmd+P on macOS, Ctrl+P on Windows/Linux)
3. Search for "Keitaro" and select it
4. You can now use the Keitaro API through Cursor

Available Tools

Campaigns

• list_campaigns - Get a list of campaigns
• get_campaign - Get information about a specific campaign
• create_campaign - Create - Create a new campaign
• update_campaign - Update an existing campaign
• delete_campaign - Delete a campaign

Traffic Streams

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

Traffic Sources

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

Offers

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

Clicks and Conversions

• 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

Reports

• get_report - Generate a report with specified parameters

Domains

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

Basic Usage

Get a list of campaigns

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

Create a new campaign

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

Get a report

get_report({
  from: "2025-01-01",
  to: "2025-01-31",
  metrics: ["clicks", "impressions", "conversions"]
})

🔧 Technical Details

Development

Run in development mode

npm run dev

Test the server

node server.js