---
title: Cursor
description: Install the AdCrunch MCP server in Cursor and authorize your organization.
---

import Steps from '#docs/components/mdx/steps.astro';
import Step from '#docs/components/mdx/step.astro';
import Callout from '#docs/components/mdx/callout.astro';
import Tabs from '#docs/components/mdx/tabs.astro';
import Tab from '#docs/components/mdx/tab.astro';

> **Tip**
>
> AdCrunch is a **remote MCP server** — there's nothing to install locally. You
> just point Cursor at the AdCrunch URL and complete an OAuth flow.

## Install

1. **Open your MCP configuration**

    In Cursor, choose **Settings → Cursor Settings → MCP** and click **Add new
    MCP server** — or edit the config file directly.

    **Tab 1**

    Edit `~/.cursor/mcp.json`:

    ```json
    {
      "mcpServers": {
        "adcrunch": {
          "url": "https://mcp.adcrunch.dev/mcp"
        }
      }
    }
    ```

    **Tab 2**

    Create `.cursor/mcp.json` in the project root:

    ```json
    {
      "mcpServers": {
        "adcrunch": {
          "url": "https://mcp.adcrunch.dev/mcp"
        }
      }
    }
    ```

2. **Authorize**

    Back in **Settings → MCP**, the `adcrunch` server appears with a login
    prompt. Click it — Cursor opens AdCrunch's OAuth consent in your browser.
    Sign in and pick the organization you want to expose to this client.

3. **Check the tools are listed**

    The server row turns green and lists tools like `list_advertisers` and
    `query_insights`.

## Try it

Open the chat in Agent mode and ask: _"List my advertisers."_ Cursor calls `list_advertisers` and reads back the result.

If that works, jump to the [recipes](/recipes).

## Troubleshooting

> **Server shows an error / no tools**
>
> Confirm the JSON is valid and the URL is exactly
> `https://mcp.adcrunch.dev/mcp`. Then toggle the server off and on in
> **Settings → MCP** to force a reconnect.