Ctrlk
Help CenterContact Support
For the complete documentation index, see llms.txt. This page is also available as Markdown.

MCP Quick Start

Configure an MCP client to use the impact MCP server, when you want an AI assistant to read data and take actions in impact.com.

Coming soon: Prepare for the future of AI connectivity! impact.com MCP is almost here.

Help shape what it does. Take our 2-minute survey and tell us which tools you want first.

Let your AI assistant interact with your impact.com data. The impact.com MCP Server gives any compatible AI tool or agent secure, real-time access to your partner marketing platform to access campaigns, reports, partners, and more.

By implementing the Model Context Protocol (MCP) standard, this cloud-based server acts as a secure bridge between AI systems and impact.com's APIs.

Powered by OAuth 2.1 authorization, your AI can search documents, pull reports, create campaigns, and manage partners through natural conversation, all while respecting your existing access controls. No API expertise is required.

Work with your impact.com data directly inside your AI assistant or IDE.

MCP is enabled by default for every impact.com account. There is nothing to switch on inside impact.com to get started. The server is available at https://mcp.impact.com/mcp and is ready to accept connections.

What You Can Do

With the impact.com MCP Server, you can:

  • Query your data: Search and summarize information from your impact.com account using natural language.

  • Create and update: Execute actions like creating campaigns, updating settings, or managing partners through simple commands.

  • Automate workflows: Streamline repetitive tasks without leaving your development environment.

The impact.com MCP Server is built for developers automating workflows, analysts pulling reports, partnership managers updating campaigns, and any team that wants intelligent access to their impact.com data without leaving their tools.

How It Works

Getting started is simple:

  • Select authenticate: Initiate the connection from your AI assistant or IDE.

  • Review and approve: A consent screen displays the permissions being requested.

  • Secure token created: Upon approval, an MCP usage token is installed in your impact.com account and securely returned to your AI assistant.

Your AI assistant now has access to interact with your impact.com data using your specific user permissions.

Security & Authentication

The impact.com MCP Server uses OAuth 2.1 authorization to ensure all actions respect your existing access controls. Your credentials are never shared directly with the AI assistant. Only a secure, revocable token is used.

A separate MCP usage token is issued per LLM client, so connecting Claude, ChatGPT, Cursor, VS Code and others each produces its own token, scoped to your specific user permissions. A refresh token is also issued, so the AI assistant can renew access without prompting you to log in again on every session.

Account-Level Controls (Administrators)

An account administrator can disable MCP for the whole account at any time. This is an all-or-nothing setting and is not configurable per user.

  1. Sign in to impact.com.

  2. Navigate to Settings → Tools → MCP.

  3. Disable MCP for the account.

When MCP is disabled at the account level, no user on that account will be able to complete the consent step described below.

Disabling MCP deletes existing tokens.

When you disable MCP for an account that has one or more MCP usage tokens already minted, all of those tokens will be deleted and every connected AI assistant will lose access immediately.

To avoid accidents, impact.com asks you to tick a confirmation checkbox acknowledging this before the change is saved. If the account has no MCP usage tokens minted yet, the checkbox will not be shown and you can disable MCP directly.

Administrators can also revoke any individual MCP usage token at any time, using the same steps described in Disconnect or Revoke Access. Revoking a token immediately invalidates that LLM's access; the user will need to consent again before the LLM can call any impact.com tools.

Connect Your Account

Follow these steps to connect your impact.com account to an LLM for MCP integration:

1

Configure impact.com MCP

Follow our setup guides for specific clients:

For other supported clients, refer to your platform's MCP documentation or built-in assistant for connection instructions.

2

Initiate Connection

Where necessary, grant the MCP access to your account, and review the permissions as they're requested.

3

Grant Consent

Review the permissions being requested, then approve access through the consent screen.

4

Token Installation

Upon approval, an MCP usage token is automatically created and stored in your impact.com account.

This token is securely returned to your AI assistant, enabling it to access impact.com data and perform actions on your behalf using your specific permissions.

The AI assistant has access to refresh the token which means that you don't have to authenticate each time. A separate token is issued for each LLM client you connect.

Disconnect or Revoke Access

You maintain full control over the connection. Because a separate token is issued per LLM client, you can disconnect one AI assistant without affecting any of the others.

  • Brand:

    • Navigate to Settings → Technical → API.

    • Locate the MCP usage token.

    • Choose to Delete the token as needed.

  • Partner:

    • Navigate to Settings → Technical → API.

    • Locate the MCP usage token.

    • Choose to Delete the token as needed.

  • Agency:

    • Navigate to Settings → Technical → API.

    • Locate the MCP usage token.

    • Choose to Delete the token as needed.

Using an AI assistant?

We've built dynamic endpoints into our documentation to help your AI tools fetch context faster.

System instructions for AI Agents:

PreviousCreate an API KeyNextMCP for Cursor

Last updated