MCP Server — continuous improvements
A batch of refinements to the read-only MCP tools, focused on counting, scoped summaries, metric clarity, and timezone correctness.count_entities— a new generic tool that returns only the match count for a type + filter set, with no records or pagination. Use it for “how many” questions instead of paginglist_offers/list_affiliates/list_entitiesand tallying. See count_entities.run_network_summaryentity filters — scope the headline totals to specificoffer,affiliate,advertiser,creative, orcampaign(pipe for OR). Combined withinclude=comparison, this answers “is offer 91 up or down vs last week?” — the filter is applied to the comparison period too. See run_network_summary.get_report_schemametric definitions — the response now includesmetric_definitions, one entry per metric with{ name, description, unit, formula, is_custom }, including this network’s user-defined custom metrics. It is the source of truth for “what metrics exist” and “how is<metric>calculated”. See get_report_schema.- Metric filters & percent metrics —
run_performance_reportacceptsmetric_filters(e.g.clicks>100,cvr<2,invalid_clicks<=0) on aggregated rows.cvr,ctr, andmarginare percentages (2.84= 2.84%);roasis a ratio. Metric descriptions/formulas are now exact. - Network timezone & currency defaults —
run_performance_report,run_network_summary, andsearch_activitynow default to the network’s timezone and base currency (matching the Everflow portal) instead of UTC/USD when those parameters are omitted. - Raw-event truncation hints — when
search_activityhits its cap it returnstruncated(andtotal_matchingfor clicks) plus anotesteering torun_performance_report(e.g.dimensions=conversion_error_code) for counts and breakdowns.
Sub and advertiser parameters extended from 5 to 10
Tracking now supportssub1–sub10 affiliate sub-parameters and adv1–adv10 advertiser parameters everywhere the first five were accepted. Existing integrations are unaffected — the new parameters are optional and omitted from payloads when empty.The expansion applies across every surface:- Tracking links and API endpoints — click and conversion endpoints accept and return the full range (600-char limit per value, unchanged)
- Reporting — available as filters and per-record fields on clicks, conversions, impressions, exports, and scheduled reports
- JavaScript SDK —
EF.click(),EF.conversion(), andEF.impression()accept the new parameters - Webhooks & Firehose — conversion webhook and Firehose payloads carry
sub1–sub10andadv1–adv10 - MCP Server —
run_performance_report,search_activity, and the event entity types filter on the full range; see Events & Attribution, the new home for click, conversion, and transaction lookup documentation
MCP Server — transaction lookup and tool consolidation
One capability added and four tools consolidated, with no net growth in the tool list.- Transaction lookup —
get_entity(type="transaction", id="<transaction ID>")returns the full attribution chain in one call: the click, its conversions (each withattribution_method), pixel-fire logs, and on-hold conversions. See get_entity. search_activityreplacessearch_clicksandsearch_conversions— settypetoclickorconversion. Same filters and data.- Deprecations —
get_click,get_conversion,search_clicks, andsearch_conversionsare now served viaget_entity/search_activity. They remain fully callable for backward compatibility but are no longer listed. See Deprecated tools for the migration table.
MCP Server — multi-value filters for performance reports
run_performance_report now matches multiple IDs for a single filter in one query. Separate values with a pipe — offer:1|2|5 — or repeat the key (offer:1,offer:2); both return all of the listed entities together instead of requiring a separate report per ID.- Supported on the ID filters:
offer,offer_group,affiliate,advertiser,creative,campaign,category,network,tracking_domain,channel - See the run_performance_report filter reference and the Compare a specific set of offers example
MCP Server — new entity types
7 additional types are now supported byget_entity, list_entities, and get_entity_schema: employee, category, channel, label, affiliate_tier, offer_url, and advertiser_event. The total number of supported entity types is now 27.- View the updated entity type reference for required filters and usage notes per type
Update Conversion Notes endpoint documented
Documentation added for the existingPUT /networks/reporting/conversions/{conversionId}/notes endpoint, which lets you attach free-form notes to a conversion. The endpoint itself is unchanged — only the docs are new.- View the Update Conversion Notes endpoint reference (Network API → Conversion Updates)
- Pass an empty string to clear existing notes
- Returns the full updated conversion record in the response
MCP Server documentation added
A new MCP tab has been added to the developer hub covering the Everflow Model Context Protocol (MCP) Server — a native integration for AI assistants (Claude, Cursor, Windsurf, and others) that gives LLMs direct, structured access to your Everflow data without custom API wrappers.- Overview — what the MCP Server is and how it works
- Quickstart — step-by-step setup for Claude Desktop, Cursor, and Windsurf
- Tools reference — all 16 read-only tools with full parameter, dimension, filter, and metric tables
- Prompt templates — ready-to-use prompts for common workflows
- Examples — real conversational walkthroughs
- FAQ — common questions and troubleshooting