Skip to main content
Connect your Extole programs to Cursor and manage referrals alongside your code. Cursor is an AI-powered code editor. Once connected to Extole, you can pull program data, check reward configurations, and make changes from Cursor’s AI chat — useful when building integrations or automations on top of Extole.

​
Requirements

Every person who wants to use the Extole MCP must complete setup individually. You’ll need:
  • Cursor 0.43 or later
  • An active Extole user account

​
Setup

Choose your authentication method. See the MCP authentication guide if you’re not sure which to use.
Step 1: Open MCP settings In Cursor, go to Cursor > Settings > Cursor Settings, then click Tools & Integrations in the left nav. Step 2: Add a new MCP server Click New MCP Server under MCP Tools. Step 3: Configure the server Cursor will create an mcp.json file. Paste the following: mcp.json Save the file. Step 4: Authorize the connection Click Connect next to the Extole MCP entry. Your browser will open to an Extole authorization page. Review the permissions and click Authorize. Step 5: Verify the connection The Extole MCP server should appear as connected in Tools & Integrations.

​
Option 2: API Key

Step 1: Get your API key Generate one at the My.Extole Security Center. Step 2: Open MCP settings In Cursor, go to Cursor > Settings > Cursor Settings, then click Tools & Integrations. Step 3: Add a new MCP server Click New MCP Server under MCP Tools. Step 4: Configure the server Paste the following into mcp.json: mcp.json Replace <YOUR_API_KEY> with your Extole API key. Save the file. Step 5: Verify the connection Check the server status in Tools & Integrations. It should show as connected.

​
Using the MCP

Once connected, use Extole tools from Cursor’s AI chat panel. Open the AI chat panel and select Agent mode, then enter a prompt:
“What’s the current conversion rate on our refer-a-friend program?”
“Show me the reward configuration for the friend offer in campaign X.”
“Update the advocate reward in the spring campaign to $25.”
Cursor will prompt you to approve each MCP tool call. Click Run tool to proceed. You can enable Yolo mode to auto-approve tool calls — useful in trusted workflows, but review carefully before enabling for write operations.
Write operations — Actions that modify programs, rewards, or campaign components execute immediately under your Extole permissions and are recorded in the Extole change log.

​
Troubleshooting

Tools not appearing — Restart Cursor after saving mcp.json. Verify the JSON is valid. “Unauthorized” — Confirm the Bearer prefix is present before your token, or re-authorize via OAuth.