> For the complete documentation index, see [llms.txt](https://knowledgebase.offer18.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.offer18.com/network/integration/mcp-integration.md).

# MCP Integration

MCP (Model Context Protocol) is an open standard that allows AI assistants such as ChatGPT, Claude, and Cursor to securely connect with your Offer18 account.

With MCP Integration, you can interact with your Offer18 account using simple, natural-language instructions. You can retrieve account data, analyze performance, generate reports directly through your AI assistant without manually navigating the Offer18 dashboard.<br>

### How to Set Up MCP Integration

Follow the steps below to connect your Offer18 account to an MCP-compatible AI assistant, such as ChatGPT, Claude, or Cursor.

#### Requirements

* An MCP-compatible AI assistant (ChatGPT, Claude, Cursor, or another supported client).
* Offer18 MCP Server URL.

#### Setup Instructions

1. **MCP Server URLs:** Use the following MCP Server URL.
   * Admin Report: `https://api.offer18.com/api/mcp/admin`
   * Affiliate Report: `https://api.offer18.com/api/mcp/affiliate`
2. **Open AI Assistant Settings:** Navigate to the connector/plugins or MCP settings in your preferred AI assistant.
3. **Add a New Connection:** Select the option to add a custom connector or MCP server. Define name as the connection name and paste the Offer18 MCP Server URL.
4. **Configure Permissions:** Grant the required permissions to allow the AI assistant to access your account data and perform supported actions.
5. **Complete the Connection:** Save the configuration and authorize the connection if prompted.
6. **Test the Integration:** Start a new conversation and try the following prompt:

   "Show my top 5 offers by revenue this week."

   If the assistant successfully retrieves your data, the connection is working.

<figure><img src="https://295230641-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F41f2EboJipeUA6flsLGK%2Fuploads%2FlrStaHjdRY9q7uBgpXRH%2FAIassistant.png?alt=media&amp;token=93352f92-2985-4594-a0af-d7888b3b0405" alt=""><figcaption></figcaption></figure>

#### Security & Access

Your MCP connection provides access to your Offer18 account based on the permissions granted. Only connect through trusted AI assistants and keep your connection credentials private. Avoid sharing sensitive URLs or authentication details in public chats or documents.

**Note:** The setup process and available authentication options may vary depending on the AI assistant you use.

#### Example Prompts

* Show my top 5 offers by revenue this week.
* Identify the traffic sources with the highest ROI in the last 30 days.
* Give me a summary of last month’s performance.

### API Authentication & Access Permissions

Offer18 provides two separate MCP server URLs, each requiring its corresponding API credentials for authentication.

* **Admin Reporting MCP Server:** Authenticate using your Admin API/security Key [Generate Admin API Key](https://knowledgebase.offer18.com/network/network-api.md).

{% hint style="info" %}
**Security Recommendation:** Create a dedicated API key specifically for MCP integration and configure the required permissions for the MCP server. Avoid using your primary account API key.
{% endhint %}

* **Affiliate Reporting MCP Server:** Authenticate using your Affiliate Reporting API Key [Generate Affiliate API Key](https://knowledgebase.offer18.com/affiliate/affiliate-apis.md).

**Important:** Ensure that you use the API key associated with the respective MCP server. When prompted during connection setup, enter the appropriate API credentials and authorize the requested permissions to establish the connection successfully.
