impact.com MCP server: affiliate reporting in Claude, Codex or Cursor
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 yourself | Agent Planners MCP | |
|---|---|---|
| Sign-in | Basic auth with the SID and token in your client | Connected once on the impact.com card; the token stays encrypted on our server |
| Reports | Pages, 45-day action windows and exports to handle | Pages followed, longer action windows split, numbers converted |
| Changes | Whatever the token allows | Every brand-side change, inquiries and deletes held for a person |
| Other platforms | impact.com only | Every platform the workspace connected, on one endpoint |
How to configure it
- 1Connect impact.com on its card on Integrations with the Account SID and Auth Token, as a publisher or a brand.
- 2Create a key in API & MCP:
tools:readfor reading, addtools:writefor changes. - 3Add the server to your client with one of the snippets below, run
describe_permissions, thenimpact__get_capabilities.
# 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}" } } } }The impact.com tools
| Tool | Kind | What it does |
|---|---|---|
impact__get | Read | ANY impact.com GET by path on the connected account (the path is relative to /Mediapartners/{SID} or /Advertisers/{SID}): e.g. |
impact__get_capabilities | Read | What 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_account | Read | The account's company information (GET CompanyInformation): name, website, currency, time zone, promotional methods. |
impact__list_programs | Read | Programs (GET Campaigns): [publisher] the brands' programs you joined — advertiser, program name, contract status, tracking link, deep-linking; [advertiser] your programs. |
impact__get_program | Read | ONE program (GET Campaigns/{id}). |
impact__list_actions | Read | Actions = 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_action | Read | ONE action (GET Actions/{id}) with its items (GET Actions/{id}/Items) when items:true. |
impact__list_action_updates | Read | Changes to actions (GET ActionUpdates): reversals, payout / amount deltas, state details. |
impact__list_action_inquiries | Read | Action 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_inquiry | Read | ONE action inquiry (GET ActionInquiries/{id}). |
impact__list_reports | Read | The reports this account can run (GET Reports): id, name, description, whether it can run over the API. |
impact__get_report_metadata | Read | A report's filters and columns (GET Reports/{id}/MetaData) — read it before run_report to know the filter names. |
impact__run_report | Read | Run 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__performance | Read | [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_report | Read | Start an asynchronous report export (GET ReportExport/{id}) → a jobId; read it with get_job. impact.com allows 100 exports a DAY. |
impact__get_job | Read | An export job's status (GET Jobs/{id}) and, once COMPLETED with download:true, its rows (GET Jobs/{id}/Download). |
impact__list_invoices | Read | Invoices (GET Invoices): id, date, the counterparty, currency, total, VAT, line items per program. |
impact__get_invoice | Read | ONE invoice (GET Invoices/{id}). |
impact__list_contracts | Read | Contracts (terms) with programs (GET Contracts; advertiser: Campaigns/{id}/Contracts): status, start / end, signatories, terms summary. |
impact__list_promo_codes | Read | Promo codes (GET PromoCodes): code, state, program, deal, credit rule, dates. |
impact__list_deals | Read | Deals (publisher: GET Campaigns/{programId}/Deals — programId required; advertiser: GET Deals): name, state, type, scope, discount, dates, default promo code. |
impact__list_ads | Read | Ads / creatives (GET Ads): id, name, program, type, tracking link, landing page, size, deal. |
impact__get_ad | Read | ONE ad (GET Ads/{id}); [publisher] trackingLink:true also returns its tracking link with your sub ids (GET Ads/{id}/TrackingLink?subId1…). |
impact__list_catalogs | Read | Product catalogs (GET Catalogs): id, name, program, number of items, currency, last update. |
impact__search_catalog_items | Read | [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_properties | Read | [publisher] Your media properties (GET MediaProperties): id, name, type (WEBSITE | MOBILE | SOCIAL), URL, ownership verified. |
impact__list_partners | Read | [advertiser] Your partners (GET MediaPartners): id, name, state, website, currency, promotional methods. |
impact__get_partner | Read | [advertiser] ONE partner (GET MediaPartners/{id}). |
impact__create_tracking_link | Write | [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_property | Write | [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_property | Write | [publisher] Change a media property (PUT MediaProperties/{id}) — read first, before → after: { accountId?, mediaPropertyId, name?, url?, description?, handle? }. |
impact__delete_media_property | Write — always a person | [publisher] Delete a media property (DELETE MediaProperties/{id}) — read first: { accountId?, mediaPropertyId }. |
impact__create_action_inquiry | Write — 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_action | Write — always a person | [advertiser] Change an action's amount / items (PUT Actions): { accountId?, actionId | orderId + actionTrackerId, amount? (MAJOR), reason, dispositionCode?, sku?, quantity? }. |
impact__reverse_action | Write — 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_inquiry | Write — 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_code | Write — 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_code | Write — always a person | [advertiser] Expire a promo code (DELETE PromoCodes/{id}): { accountId?, promoCodeId }. |
impact__create_deal | Write — always a person | [advertiser] Create a deal (POST Deals): { accountId?, programId, name, scope, type, description?, startDate?, endDate?, discountType?, discountAmount?, discountPercent?, defaultPromoCode? }. |
impact__update_deal | Write — always a person | [advertiser] Change a deal (PUT Deals/{id}) — read first: { accountId?, dealId, …the fields to change }. |
impact__accept_contract | Write — always a person | [advertiser] Accept a partner's pending contract (POST Programs/{id}/Contracts): { accountId?, programId, contractId, groupId? }. |
impact__decline_contract | Write — always a person | [advertiser] Decline a pending contract (DELETE Programs/{id}/Contracts): { accountId?, programId, contractId, reason? }. |
impact__update_partner_values | Write — always a person | [advertiser] Set a partner's custom values (PUT MediaPartners/{id}): { accountId?, partnerId, value1?, value2?, value3? }. |
impact__create_partner_tracking_link | Write — always a person | [advertiser] Generate a tracking link for a partner (POST Programs/{id}/TrackingLinks?MediaPartnerId=): { accountId?, programId, partnerId, deepLink?, adId? }. |
impact__mutate | Write | Any other impact.com write by path on the connected account: { accountId?, method: POST | PUT | PATCH | DELETE, path (relative, e.g. |
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.
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.