Keitaro TDS API MCP Plugin

Integrations

  • Uses environment variables for configuration, specifically for storing Keitaro API URL and API key.

  • Used for installation of the MCP server through repository cloning.

  • Provides JavaScript examples for interacting with the Keitaro TDS API, allowing users to manage campaigns, traffic streams, offers, and generate reports.

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

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
  1. Add the following entry to the "mcpServers" object:
"Keitaro": { "command": "mcp-keitaro-tds", "args": [] }
  1. 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
-
security - not tested
F
license - not found
-
quality - not tested

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.

  1. Description
    1. Installation
      1. Installing the plugin in Cursor
      2. Alternative: Manual configuration in Cursor
      3. API Key Configuration
    2. Usage in Cursor
      1. Available Tools
        1. Campaigns
        2. Traffic Streams
        3. Traffic Sources
        4. Offers
        5. Clicks and Conversions
        6. Reports
        7. Domains
      2. Usage Examples
        1. Getting a list of campaigns
        2. Creating a new campaign
        3. Getting a report
      3. Development
        1. Running in development mode
        2. Testing the MCP server

      Related MCP Servers

      • A
        security
        A
        license
        A
        quality
        A powerful MCP server for fetching and transforming web content into various formats (HTML, JSON, Markdown, Plain Text) with ease.
        Last updated -
        4
        146
        12
        TypeScript
        MIT License
        • Apple
        • Linux
      • -
        security
        F
        license
        -
        quality
        A configurable MCP server that dynamically loads capabilities from a remote configuration to bridge MCP clients with remote APIs for executing actions, accessing resources, and utilizing prompt templates.
        Last updated -
        1,261
        4
        TypeScript
      • -
        security
        F
        license
        -
        quality
        An MCP server that provides tools and resources for managing a coding project's todo list, allowing users to view, add, update, and delete todo items with details like priority, status, and tags.
        Last updated -
        1
        Python
      • -
        security
        A
        license
        -
        quality
        An MCP server that enables fetching web content using the Node.js undici library, supporting various HTTP methods, content formats, and request configurations.
        Last updated -
        66
        8
        TypeScript
        MIT License
        • Apple
        • Linux

      View all related MCP servers

      ID: iy1fgw1o6g