---
updatedAt: 2026-04-29T13:44:05.000Z
agentTools:
  projectIndex: https://developers.pinpointhq.com/llms.txt
---

# MCP

The Pinpoint Model Context Protocol (MCP) server enables AI-powered code editors like Cursor and Windsurf, plus general-purpose tools like Claude Desktop, to interact directly with your Pinpoint API documentation and execute API requests to get data from your Pinpoint account.

## What is MCP?

Model Context Protocol (MCP) is an open standard that allows AI applications to securely access external data sources and tools. The Pinpoint MCP server provides AI agents with:

* **Direct API access** to Pinpoint functionality
* **Documentation search** capabilities
* **Real-time data** from your Pinpoint account
* **Code generation** assistance for Pinpoint integrations

## Pinpoint MCP Server Setup

Pinpoint hosts a remote MCP server at `https://developers.pinpointhq.com/mcp`. Configure your AI development tools to connect to this server.

<Tabs>
  <Tab title="Cursor">
    **Add to`~/.cursor/mcp.json`:**

    ```json
    {
      "mcpServers": {
        "pinpoint": {
          "url": "https://developers.pinpointhq.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Windsurf">
    **Add to`~/.codeium/windsurf/mcp_config.json`:**

    ```json
    {
      "mcpServers": {
        "pinpoint": {
          "url": "https://developers.pinpointhq.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Desktop">
    **Add to`claude_desktop_config.json`:**

    ```json
    {
      "mcpServers": {
        "pinpoint": {
          "url": "https://developers.pinpointhq.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Code">
    **Run in terminal:**

    ```bash
    claude mcp add --transport http pinpoint \ 
      "https://developers.pinpointhq.com/mcp"
    ```

    That will add the following to your `claude.json`:

    ```json
    {
      "mcpServers": {
        "pinpoint": {
          "type": "http",
            "url": "https://developers.pinpointhq.com/mcp"
        }
      }
    }
    ```
  </Tab>
</Tabs>

### Executing requests

MCP server has `execute-request` tool, which your AI tool can use to do real API requests to your Pinpoint instance. To enable this, you need to add the API key and the host to the MCP configuration (passing `headers`):

<Callout icon="❗️" theme="error">
  We highly recommend creating a separate API key with **read-only** permission for usage with your AI tool.

  MCP allows calling every API endpoint including those which create/update/remove data. Separate API key with read-only will ensure your **AI tool won't cause any unintended data modifications/removal.**
</Callout>

<Callout icon="📘" theme="info">
  Not all AI tools allow for passing headers to MCP calls. Some tools require paid accounts to do so.  
  E.g. `ChatGPT` dosn't support passing headers.
</Callout>

<Tabs>
  <Tab title="Cursor">
    **Add to`~/.cursor/mcp.json`:**

    ```json
    {
      "mcpServers": {
        "pinpoint": {
          "url": "https://developers.pinpointhq.com/mcp",
          "headers": {
            "X-API-KEY": "<<YOUR-PINPOINT-API-KEY>>",
            "X-Original-Host": "<<YOUR-SUBDOMAIN>>.pinpointhq.com"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Windsurf">
    **In`~/.codeium/windsurf/mcp_config.json`:**

    ```json
    {
      "mcpServers": {
        "pinpoint": {
          "url": "https://developers.pinpointhq.com/mcp",
          "headers": {
            "X-API-KEY": "<<YOUR-PINPOINT-API-KEY>>",
            "X-Original-Host": "<<YOUR-SUBDOMAIN>>.pinpointhq.com"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Code">
    In `claude.json`:

    ```json
    {
      "mcpServers": {
        // other mcpServers
        "pinpoint": {
          "type": "http",
          "url": "https://developers.pinpointhq.com/mcp",
          "headers": {
            "X-API-KEY": "<<YOUR-PINPOINT-API-KEY>>",
            "X-Original-Host": "<<YOUR-SUBDOMAIN>>.pinpointhq.com"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Desktop">
    **!!! Requires`node` with `npx` to be installed**

    In `claude_desktop_config.json`:

    ```json
    {
      "mcpServers": {
        "pinpointApi": {
          "command": "/usr/local/bin/npx", // this needs to be a path to your `npx`, find with `which npx`
          "args": [
            "mcp-remote",
            "https://developers.pinpointhq.com/mcp",
            "--header",
            "x-api-key:<<YOUR_API_KEY>>",
            "--header",
            "X-Original-Host:<<YOUR_SUBDOMAIN>>.pinpointhq.com"
          ],
          "env": {
            "PATH": "/usr/local/bin:/usr/bin:/bin" // needs to include paths to `npx` and `node`
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Microsoft Copilot">
    There are two methods to use Pinpoint MCP with Microsoft Copilot:

    * [Manually entering the MCP details](https://developers.pinpointhq.com/reference/connecting-pinpoint-to-microsoft-copilot-studio-via-mcp)
    * [Using MCP configuration file](https://developers.pinpointhq.com/reference/onfiguring-pinpoint-mcp-in-microsoft-copilot-with-configuration-file)
  </Tab>
</Tabs>

## Testing Your MCP Setup

Once configured, you can test your MCP server connection:

1. **Open your AI editor/CLI** (Cursor, Windsurf, Claude etc.)
2. **Start a new chat** with the AI assistant
3. **Ask about Pinpoint** - try questions like:
   * "How do I create a new application?"
   * "Show me an example of custom fields creation"
   * "Create an assessment integration using Pinpoint"
   * "Prepare a report from the last 50 candidates"
   * "Which countries do we get most applications from?"

The AI should now have access to your Pinpoint account data and documentation through the MCP server.

## List of tools

<Table>
  <thead>
    <tr>
      <th>
        Tool
      </th>

      <th>
        What it does
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `list-specs`
      </td>

      <td>
        Lists all API specs available in the project, with their titles
      </td>
    </tr>

    <tr>
      <td>
        `list-endpoints`
      </td>

      <td>
        Returns all API paths and HTTP methods with their summaries
      </td>
    </tr>

    <tr>
      <td>
        `get-endpoint`
      </td>

      <td>
        Returns full details on a specific endpoint: description, parameters, security
      </td>
    </tr>

    <tr>
      <td>
        `get-request-body`
      </td>

      <td>
        Returns the request body schema for an endpoint
      </td>
    </tr>

    <tr>
      <td>
        `get-response-schema`
      </td>

      <td>
        Returns the response schema for a specific endpoint and status code
      </td>
    </tr>

    <tr>
      <td>
        `list-security-schemes`
      </td>

      <td>
        Lists all authentication methods defined in your API spec
      </td>
    </tr>

    <tr>
      <td>
        `search-specs`
      </td>

      <td>
        Case-insensitive search across all paths, operations, and schemas
      </td>
    </tr>

    <tr>
      <td>
        `execute-request`
      </td>

      <td>
        Makes a live API call and returns the response.  
        **Requires auth headers to be forwarded**  
        (see _Executing requests_ section above)
      </td>
    </tr>

    <tr>
      <td>
        `get-code-snippet`
      </td>

      <td>
        Generates a working code snippet for any endpoint in any programming language
      </td>
    </tr>
  </tbody>
</Table>

<br />

### FAQ

**Can I use Pinpoint MCP with ChatGPT or Gemini?**

Yes, but only for documentation access. ChatGPT and Gemini don't allow setting up to execute API requests (because there is no way to configure custom headers).

**Can I use Pinpoint MCP with Microsoft Copilot?**

Yes! Please find the setup instructions below.

There are two methods to use Pinpoint MCP with Microsoft Copilot:

* [Manually entering the MCP details](https://developers.pinpointhq.com/reference/connecting-pinpoint-to-microsoft-copilot-studio-via-mcp)
* [Using MCP configuration file](https://developers.pinpointhq.com/reference/onfiguring-pinpoint-mcp-in-microsoft-copilot-with-configuration-file)