How to Connect to our Model Context Protocol (MCP) Server

Amplify MCP Server Documentation

The Amplify MCP Server is a plug-and-play solution for the Model Context Protocol (MCP) that allows AI agents to seamlessly interact with the Amplify API and Dashboard. This eliminates the need for complex integrations.

Installation Guide

Step 1: Create Amplify Account

If you don’t already have an Amplify account, go to my.outbrain.com and sign up for an account.

Step 2: Generate an API Token

To interact with Amplify API, you’ll need an API token:

1. Go to https://lp.outbrain.com/partner-api-form/ and apply for API access and await for approval 
2. Log in to your Amplify account
3. Click on your email in the top-right corner
4. Select “Amplify API Token” 
5. Type in your password and 2FA code
6. Copy your personal access token

Step 3: Configure Your MCP Client

Automatic setup (Claude, VSCode or Cursor)

You can use our automatic installer. This requires Node Package Manager (NPM) which is a part of Node.js runtime, please follow the installation instructions on Node.js website.

Manual setup

Please follow the instructions based on your client:

Setting up MCP server with VSCode
Setting up MCP server with IntelliJ
Setting up MCP server with Cursor AI
Setting up MCP server with Claude Desktop

Option 1: Direct Integration (If Supported)

If your client supports remote MCP servers and sending custom headers, use the following configuration:

{
  "mcpServers": {
    "amplify-mcp-server": {
      "type": "http",
      "url": "https://amplifymcp.outbrain.com/AmplifyMcp/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Replace YOUR_API_TOKEN with the API token you generated in Step 2.

Option 2: Proxy Configuration (If Direct Integration Fails)

If your client does not support direct integration or you encounter 403 HTTP errors, use the following proxy configuration. This requires Node Package Manager (NPM) which is a part of Node.js runtime, please follow the installation instructions on Node.js website.

{
  "mcpServers": {
    "amplify-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://amplifymcp.outbrain.com/AmplifyMcp/mcp/",
        "--header",
        "Authorization:${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Replace YOUR_API_TOKEN with the API token you generated in Step 2.

Step 4: Test Your Integration

To verify the integration, ask your AI assistant questions such as:

• What are my active campaigns right now?
• Please disable the campaign “Test Campaign 123”.
• Can you get me a list of all my content for the “Product Launch” campaign?
• Enable content ID 987654.
• Change the daily budget for the “Promotion” campaign to $50.
• Who are my marketers associated with this account?
• Show me all campaigns for marketer John Doe.

Your assistant should now be able to interact with your Amplify account!

Available Tools

Our MCP server provides a set of tools that give AI assistants the ability to interact with Amplify dashboard: