Guides
MarketplacePartnersBlogPerk →

Connect a client to the Perk MCP server

Connect an MCP client to the Perk MCP server at https://mcp.perk.com/api/mcp/mcp. Step-by-step setup for Claude Code, Cursor, Codex, the MCP Inspector, and any MCP-compatible client, with OAuth 2.0 sign-in.

This article shows you how to connect an AI client to the Perk Model Context Protocol (MCP) server so it can query your Perk data. Any MCP-compatible client connects using a single server URL, and Dynamic Client Registration (DCR) handles credentials for you.

Server URL

Connect your client to the Perk MCP server using this production server URL:

https://mcp.perk.com/api/mcp/mcp

The server uses streamable HTTP transport. Any MCP-compatible client connects to this URL — the per-client instructions below differ only in how you register the server with each tool.

📘

Note

A test environment is available. Where you need a non-production URL, confirm its base URL with the Perk API team. OAuth 2.0 discovery metadata is host-specific, so use the exact server URL you configured — for example, do not swap 127.0.0.1 for localhost or the reverse.

Connect Claude Code

Add the Perk MCP server to Claude Code with the claude mcp add command. Pass the HTTP transport and the server URL:

claude mcp add --transport http perk https://mcp.perk.com/api/mcp/mcp

Connect Cursor

Add the Perk MCP server to Cursor by editing an mcp.json file. Use ~/.cursor/mcp.json for a global configuration or .cursor/mcp.json for a single project:

{
  "mcpServers": {
    "perk": {
      "url": "https://mcp.perk.com/api/mcp/mcp"
    }
  }
}

Connect Codex

Add the Perk MCP server to Codex with the codex mcp add command. Pass the server URL:

codex mcp add perk --url https://mcp.perk.com/api/mcp/mcp

Connect VS Code

Add Perk to VS Code from the command line with the code --add-mcp command.

  1. In your terminal, run:
code --add-mcp "{\"name\":\"perk\",\"type\":\"http\",\"url\":\"https://mcp.perk.com/api/mcp/mcp\"}"
  1. Reload VS Code if prompted.
  2. Sign in with your Perk account when prompted.
📘

Note

You need the code command available in your terminal — in VS Code, run Shell Command: Install 'code' command in PATH from the Command Palette first.

Connect the MCP Inspector

Connect the MCP Inspector to the server URL https://mcp.perk.com/api/mcp/mcp. Leave the client ID and secret fields empty — Dynamic Client Registration (DCR) handles registration.

Complete the browser consent step

After you add the server, the client opens your browser to complete OAuth 2.0 sign-in and consent. Sign in with your existing Perk credentials and approve the access the client requests. The client then receives an access token and can call Perk tools. For a full walkthrough of the flow, see Authenticate with the Perk MCP server.

Next steps