Is there an MCP server for impact.com?

Yes. Agent Planners runs a hosted MCP server at https://www.agentplanners.com/api/mcp that gives Claude, ChatGPT, Codex and other MCP clients 28 impact.com read tools and 17 write tools. Sign in with OAuth or an API key. Writes follow your approval settings; changes you can't take back wait for a person unless an admin exempts a key.

MCP

impact.com MCP server: affiliate reporting in Claude, Codex or Cursor

TL;DR

impact.com reaches Claude, Codex or Cursor through the Agent Planners MCP endpoint: 26 reads and 6 writes on a publisher connection and 25 reads and 12 writes on an advertiser connection, with the token's scopes as the limit.

What this setup adds

Calling impact.com's API yourselfAgent Planners MCP
Sign-inBasic auth with the SID and token in your clientConnected once on the impact.com card; the token stays encrypted on our server
ReportsPages, 45-day action windows and exports to handlePages followed, longer action windows split, numbers converted
ChangesWhatever the token allowsEvery brand-side change, inquiries and deletes held for a person
Other platformsimpact.com onlyEvery platform the workspace connected, on one endpoint

How to configure it

  1. 1Connect impact.com on its card on Integrations with the Account SID and Auth Token, as a publisher or a brand.
  2. 2Create a key in API & MCP: tools:read for reading, add tools:write for changes.
  3. 3Add the server to your client with one of the snippets below, run describe_permissions, then impact__get_capabilities.
bash
# Claude Code
claude mcp add --transport http agent-planners https://www.agentplanners.com/api/mcp \
  --header "Authorization: Bearer $AGENTPLANNERS_API_KEY"

# Codex (signs in with OAuth in the browser)
codex mcp add agent-planners --url https://www.agentplanners.com/api/mcp

# Cursor (~/.cursor/mcp.json)
{ "mcpServers": { "agent-planners": { "url": "https://www.agentplanners.com/api/mcp", "headers": { "Authorization": "Bearer ${env:AGENTPLANNERS_API_KEY}" } } } }
Every client's setup, including OAuth sign-in without a key: MCP setup guide.

The impact.com tools

ToolKindWhat it does
impact__getReadANY impact.com GET by path on the connected account (the path is relative to /Mediapartners/{SID} or /Advertisers/{SID}): e.g.
impact__get_capabilitiesReadWhat this impact.com connection can read — the kind (publisher / advertiser) and, per area (programs, actions, reports, invoices, contracts, promo codes, ads, catalogs, media properties, partners, company information)…
impact__get_accountReadThe account's company information (GET CompanyInformation): name, website, currency, time zone, promotional methods.
impact__list_programsReadPrograms (GET Campaigns): [publisher] the brands' programs you joined — advertiser, program name, contract status, tracking link, deep-linking; [advertiser] your programs.
impact__get_programReadONE program (GET Campaigns/{id}).
impact__list_actionsReadActions = conversions credited (GET Actions): id, program, state (PENDING | APPROVED | REVERSED), payout, sale amount, currency, event / locking / cleared dates, ad, promo code, sub ids.
impact__get_actionReadONE action (GET Actions/{id}) with its items (GET Actions/{id}/Items) when items:true.
impact__list_action_updatesReadChanges to actions (GET ActionUpdates): reversals, payout / amount deltas, state details.
impact__list_action_inquiriesReadAction inquiries = claims for missing / incorrect credit (GET ActionInquiries): order id, transaction date / amount, inquiry type, expected and final payout, resolution status and reason.
impact__get_action_inquiryReadONE action inquiry (GET ActionInquiries/{id}).
impact__list_reportsReadThe reports this account can run (GET Reports): id, name, description, whether it can run over the API.
impact__get_report_metadataReadA report's filters and columns (GET Reports/{id}/MetaData) — read it before run_report to know the filter names.
impact__run_reportReadRun a report now (GET Reports/{id}; up to 20,000 rows per page): numbers come back as numbers, column names cleaned (impact.com spells "Sale Amount" Sale_zzzAmount).
impact__performanceRead[publisher] Your performance from impact.com's own reports in one call: by = day (default) | program | month | ad | country | device | subid | promo_code | referring_domain; clicks, actions, sale amount, earnings (act…
impact__export_reportReadStart an asynchronous report export (GET ReportExport/{id}) → a jobId; read it with get_job. impact.com allows 100 exports a DAY.
impact__get_jobReadAn export job's status (GET Jobs/{id}) and, once COMPLETED with download:true, its rows (GET Jobs/{id}/Download).
impact__list_invoicesReadInvoices (GET Invoices): id, date, the counterparty, currency, total, VAT, line items per program.
impact__get_invoiceReadONE invoice (GET Invoices/{id}).
impact__list_contractsReadContracts (terms) with programs (GET Contracts; advertiser: Campaigns/{id}/Contracts): status, start / end, signatories, terms summary.
impact__list_promo_codesReadPromo codes (GET PromoCodes): code, state, program, deal, credit rule, dates.
impact__list_dealsReadDeals (publisher: GET Campaigns/{programId}/Deals — programId required; advertiser: GET Deals): name, state, type, scope, discount, dates, default promo code.
impact__list_adsReadAds / creatives (GET Ads): id, name, program, type, tracking link, landing page, size, deal.
impact__get_adReadONE ad (GET Ads/{id}); [publisher] trackingLink:true also returns its tracking link with your sub ids (GET Ads/{id}/TrackingLink?subId1…).
impact__list_catalogsReadProduct catalogs (GET Catalogs): id, name, program, number of items, currency, last update.
impact__search_catalog_itemsRead[publisher] Search products across the programs' catalogs (GET Catalogs/ItemSearch, or one catalog's Items): name, price, original price, discount, stock, URL.
impact__list_media_propertiesRead[publisher] Your media properties (GET MediaProperties): id, name, type (WEBSITE | MOBILE | SOCIAL), URL, ownership verified.
impact__list_partnersRead[advertiser] Your partners (GET MediaPartners): id, name, state, website, currency, promotional methods.
impact__get_partnerRead[advertiser] ONE partner (GET MediaPartners/{id}).
impact__create_tracking_linkWrite[publisher] Create a tracking link for a program you joined (POST Programs/{programId}/TrackingLinks): { accountId?, programId, deepLink? (a page on the brand's site — only where the program allows deep linking), adId…
impact__create_media_propertyWrite[publisher] Add a media property (POST MediaProperties): { accountId?, name, type: WEBSITE | MOBILE | SOCIAL, url, description?, socialPlatform? (SOCIAL: INSTAGRAM | YOUTUBE | X/TWITTER | FACEBOOK | PINTEREST | TWITCH…
impact__update_media_propertyWrite[publisher] Change a media property (PUT MediaProperties/{id}) — read first, before → after: { accountId?, mediaPropertyId, name?, url?, description?, handle? }.
impact__delete_media_propertyWrite — always a person[publisher] Delete a media property (DELETE MediaProperties/{id}) — read first: { accountId?, mediaPropertyId }.
impact__create_action_inquiryWrite — always a person[publisher] Ask a brand for missing / incorrect credit (POST ActionInquiries): { accountId?, programId, orderId, transactionDate (ISO), transactionAmount (MAJOR), inquiryType: UNTRACKED | INCORRECT | DECLINED, expecte…
impact__update_actionWrite — always a person[advertiser] Change an action's amount / items (PUT Actions): { accountId?, actionId | orderId + actionTrackerId, amount? (MAJOR), reason, dispositionCode?, sku?, quantity? }.
impact__reverse_actionWrite — always a person[advertiser] Reverse an action (DELETE Actions with DispositionCode): { accountId?, actionId | orderId + actionTrackerId, dispositionCode: REJECTED | CONS_INFO_INVALID | CONS_ERROR | CONS_FRAUD | ITEM_RETURNED | ITEM_…
impact__resolve_action_inquiryWrite — always a person[advertiser] Approve or reject a partner's inquiry (PUT ActionInquiries): { accountId?, inquiryId, resolutionStatus: VALID | DECLINED | INCOMPLETE, rejectReason? (one of impact.com's listed reasons), finalPayout? (MAJ…
impact__create_promo_codeWrite — always a person[advertiser] Assign a promo code to a partner (POST PromoCodes): { accountId?, programId, partnerId, code, type: LI (exact) | RE (regex), creditPolicy: ALWAYS | INVOLVED | WINNER, startDate?, endDate?, dealId? }.
impact__expire_promo_codeWrite — always a person[advertiser] Expire a promo code (DELETE PromoCodes/{id}): { accountId?, promoCodeId }.
impact__create_dealWrite — always a person[advertiser] Create a deal (POST Deals): { accountId?, programId, name, scope, type, description?, startDate?, endDate?, discountType?, discountAmount?, discountPercent?, defaultPromoCode? }.
impact__update_dealWrite — always a person[advertiser] Change a deal (PUT Deals/{id}) — read first: { accountId?, dealId, …the fields to change }.
impact__accept_contractWrite — always a person[advertiser] Accept a partner's pending contract (POST Programs/{id}/Contracts): { accountId?, programId, contractId, groupId? }.
impact__decline_contractWrite — always a person[advertiser] Decline a pending contract (DELETE Programs/{id}/Contracts): { accountId?, programId, contractId, reason? }.
impact__update_partner_valuesWrite — always a person[advertiser] Set a partner's custom values (PUT MediaPartners/{id}): { accountId?, partnerId, value1?, value2?, value3? }.
impact__create_partner_tracking_linkWrite — always a person[advertiser] Generate a tracking link for a partner (POST Programs/{id}/TrackingLinks?MediaPartnerId=): { accountId?, programId, partnerId, deepLink?, adId? }.
impact__mutateWriteAny other impact.com write by path on the connected account: { accountId?, method: POST | PUT | PATCH | DELETE, path (relative, e.g.
A tool marked [publisher] or [advertiser] answers only on that kind of connection; the other kind gets a sentence and no call.

What waits for a person, whatever the key allows

A tools:write key's ordinary impact.com writes — a tracking link, adding or editing a media property — either run inside the workspace's guardrails or queue for an admin. These are held for a person on every key mode:

  • Every advertiser (brand) change.
  • An action inquiry — a claim sent to a brand.
  • Deleting a media property, and gateway writes to actions, contracts, promo codes or deals, and any delete.
Refused outright: credentials, users, invoices, payments and another account's paths. impact.com setup guide · impact.com platform page · impact.com MCP server

Frequently asked questions

Does the impact.com MCP server work for brands?
Yes, with an advertiser connection. Reads run as usual; every brand-side change is held for a person.
Why does an impact.com call answer that the area is not available?
The token's scopes decide what answers. The connection records which areas the token can read; impact__get_capabilities shows them.

About this platform

Put a human-approved agent on your ad ops

Start free — 2,500 credits a month, no credit card. Reads run at once; by default every write waits for your approval.

Related reading