Skip to content

AffDeveloper/everflow-mcp-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Everflow MCP Server

An MCP (Model Context Protocol) server that connects AI assistants to your Everflow partner marketing platform. Manage offers, affiliates, advertisers, reporting, tracking links, and conversions through natural language.

Tools

Tool Description
list_offers List and filter offers by status
get_offer Get offer details
create_offer Create a new offer
update_offer Update an existing offer
list_offer_urls List tracking URLs for an offer
list_affiliates List and filter affiliates by status
get_affiliate Get affiliate details
list_affiliate_tiers List affiliate tier configurations
list_advertisers List and filter advertisers
get_advertiser Get advertiser details
get_dashboard_stats Dashboard overview (clicks, conversions, revenue, payout)
get_aggregated_report Performance report grouped by affiliate, offer, country, etc.
list_raw_conversions Raw conversion events with full detail
list_raw_clicks Raw click events with full detail
list_event_report Custom event/postback report data
create_tracking_link Generate a tracking link for an affiliate + offer
list_coupon_codes List promo/coupon codes
update_conversion Approve, reject, or adjust a conversion
list_smart_links List smart link configurations
list_creatives List creative assets for an offer

Setup

1. Get your API key

In your Everflow account, go to Control Center > Security and create a new API key. The key is shown only once -- save it immediately.

2. Install

Claude Desktop / Claude Code

Add to your MCP config (claude_desktop_config.json or .claude.json):

{
  "mcpServers": {
    "everflow": {
      "command": "npx",
      "args": ["@power-consulting/everflow-mcp-server"],
      "env": {
        "EVERFLOW_API_KEY": "your-api-key"
      }
    }
  }
}

EU Accounts

For EU-hosted Everflow accounts, add the base URL override:

{
  "mcpServers": {
    "everflow": {
      "command": "npx",
      "args": ["@power-consulting/everflow-mcp-server"],
      "env": {
        "EVERFLOW_API_KEY": "your-api-key",
        "EVERFLOW_BASE_URL": "https://api-eu.eflow.team/v1"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json using the same format as above.

3. Restart your AI tool

The Everflow tools will appear in your tool list.

Usage Examples

Once connected, you can ask your AI assistant things like:

  • "Show me all active offers"
  • "Pull a performance report by affiliate for last week"
  • "List raw conversions for offer #42 yesterday"
  • "Generate a tracking link for affiliate 100 on offer 50"
  • "What are my dashboard stats for this month?"
  • "Approve conversion #12345"

API Limits

  • 20 requests/second (network keys)
  • 10 concurrent requests on reporting endpoints
  • 1,000 queries/hour on BigQuery-backed endpoints (geo, device detail)
  • 365-day max lookback on data queries

Security

Your API key never leaves your machine. The server runs locally and communicates directly with the Everflow API using your key stored in environment variables.

License

MIT

About

MCP server for Everflow partner marketing platform

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors