MCP Server — reporting trust and read-tool refinements
- Conversions by transaction —
list_entities(type="conversion", filters={"transaction_id":…})returns all conversions for a transaction as a flat, paginated list (no date range). See Events & Attribution. - Creative markup —
get_entity(type="creative")returns the full record includinghtml_code;list_entitiesstays lean. See Supported entity types. advertiser_eventby offer —list_entities(type="advertiser_event")acceptsoffer_idin place ofadvertiser_id(the advertiser is resolved from the offer).applied_query—run_performance_reportandrun_network_summaryecho the resolved query (date window, timezone, currency, filters) so results are reproducible. See run_performance_report.metric_glossary— both reporting tools include inline definitions for the easily-misread metrics (the conversion-counting family, event revenue, percent vs ratio).- Server-side
totals—run_performance_reportreturns atotalsobject over the full matched set, with ratios re-derived from the sums rather than averaged — so you never sum rows yourself. - Capability onboarding — the server now advertises what it can do (and starter questions) to the client on connect, so “what can you help me with?” gets a grounded answer. See Quickstart.
Traffic Health — Network API endpoints and MCP tools
Traffic Health — the operational health of the domains and hosting IPs behind your tracking and conversion links (uptime, SSL, DNS and expiry incidents, blocklist reputation, remediation tasks, and per-domain hosting/SSL, assignment and revenue detail) — is now available through both the Network API and the MCP Server.- Network API — a full Traffic Health reference covering network-wide and per-domain situation, incidents, tasks, blocklist reputation, assignments, usage, and mismatches. Start with Get Traffic Health Access.
- MCP Server — two read-only tools:
list_traffic_healthfor network-wide rollups andget_traffic_health_domainfor one domain’s full picture in a single call. See Traffic Health tools. - Free vs Premium — core health, tasks, hosting and SSL are available to any network with Traffic Health enabled; blocklist reputation, external domain monitoring, and per-domain assignments/usage require Traffic Health Premium. Premium-only requests return a notice instead of data rather than erroring.
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