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

Clone the repository

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

Install dependencies

npm install

Install the package globally

npm install -g .

Install the plugin in Cursor

node install-cursor-plugin.js

Restart Cursor

Alternative: Manual configuration in Cursor

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

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

Add the following entry to the "mcpServers" object:

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

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

Launch Cursor
Open the command palette (Cmd+P on macOS or Ctrl+P on Windows/Linux)
Find "Keitaro" and select it
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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

Related MCP Servers

mcp-nodejs-server
gentoro-GT
-
security
A
license
-
quality
MCP Server for the Gentoro services, enabling Claude to interact with Gentoro, which allows users to create and integrate tools into a common Bridge, defining all available capabilities.
Last updated -
23
5
TypeScript
Apache 2.0
TeamRetro MCP Server
adepanges
A
security
A
license
A
quality
An unofficial MCP server that enables Claude to interact with TeamRetro.com's API for team retrospective management, providing direct pass-through to TeamRetro's public API endpoints with multiple authentication options.
Last updated -
11
60
TypeScript
Apache 2.0
Context Bank MCP
vulh1209
-
security
A
license
-
quality
An MCP server that provides an interface for querying the AtherOS knowledge base through an API, allowing users to create chat sessions and send queries to retrieve information.
Last updated -
JavaScript
MIT License
trykittai-mcp-server
avivshafir
-
security
A
license
-
quality
trykittai-mcp-server
Last updated -
Python
MIT License

View all related MCP servers

Keitaro TDS API MCP Plugin