Keitaro MCP

by godzilladancer

2 stars

198 downloads

Not rated

GitHub

About

Integration with Keitaro TDS API, providing tools to work with campaigns, streams, offers, and other Keitaro entities.

Details

Author: godzilladancer
Repository: GodzillaDancer/keitaro-mcp
GitHub stars: 2
Downloads: 198
Categories: AI, API, Developer Tools
Tags: #integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Keitaro MCP

Command (node, npx, python, etc.) mcp-keitaro-tds
Environment
- KEITARO_API_KEY your-api-key
- KEITARO_API_URL http://your-keitaro-domain.com/admin_api/v1
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

JSON

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

JSON

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

JSON

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

JSON

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

JSON

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

JSON

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

JSON

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

JSON

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

JSON

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

JSON

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

From the repository

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

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

1. Open the Cursor MCP configuration file:

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

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

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

bash
npm run dev
```

`list_campaigns`

Get a list of campaigns.

`get_campaign`

Get information about a specific campaign.

`create_campaign`

Create a new campaign. Parameters: name (string), type (string), cost_type (string), cost_value (number), group_id (number), state (string), traffic_source_id (number).

`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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "keitaro mcp": {
            "env": {
                "KEITARO_API_KEY": "your-api-key",
                "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
            },
            "args": [],
            "command": "mcp-keitaro-tds"
        }
    }
}

Linux

{
    "env": {
        "KEITARO_API_KEY": "your-api-key",
        "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
    },
    "args": [],
    "command": "mcp-keitaro-tds"
}

Macos

{
    "env": {
        "KEITARO_API_KEY": "your-api-key",
        "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
    },
    "args": [],
    "command": "mcp-keitaro-tds"
}

Windows

{
    "env": {
        "KEITARO_API_KEY": "your-api-key",
        "KEITARO_API_URL": "http://your-keitaro-domain.com/admin_api/v1"
    },
    "args": [],
    "command": "mcp-keitaro-tds"
}

Keitaro TDS API MCP Plugin

Description

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

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 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

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 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

Usage in Cursor

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

Available Tools

Campaigns

- 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

Traffic Streams

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

Traffic Sources

- list_traffic_sources - get a 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

Usage Examples

Getting a list of campaigns

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

Creating a new campaign

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

Getting a report

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

Development

Running in development mode

npm run dev

Testing the MCP server

npm run inspect

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

list_campaigns

get_campaign

create_campaign

update_campaign

delete_campaign

list_streams

get_stream

list_traffic_sources

get_traffic_source

list_offers

get_offer

list_clicks

get_click

list_conversions

get_conversion

get_report

list_domains

get_domain

Claude Desktop / Cursor

Linux

Macos

Windows

Keitaro TDS API MCP Plugin

Description

Installation

Installing the plugin in Cursor

Alternative: Manual configuration in Cursor

On Windows

On Linux

API Key Configuration

Usage in Cursor

Available Tools

Campaigns

Traffic Streams

Traffic Sources

Offers

Clicks and Conversions

Reports

Domains

Usage Examples

Getting a list of campaigns

Creating a new campaign

Getting a report

Development

Running in development mode

Testing the MCP server

Install

More like this

GitLab

Context 7

1Panel

🔎 GPT Researcher

Serena

FastMCP v2 🚀

`list_campaigns`

`get_campaign`

`create_campaign`

`update_campaign`

`delete_campaign`

`list_streams`

`get_stream`

`list_traffic_sources`

`get_traffic_source`

`list_offers`

`get_offer`

`list_clicks`

`get_click`

`list_conversions`

`get_conversion`

`get_report`

`list_domains`

`get_domain`