Skip to main content

MCP Authentication

ValueMapper MCP supports OAuth 2.0 Authorization Code flow for authenticated tools such as get_account and get_promotions.

  1. Connect ValueMapper MCP at https://mcp.valuemapper.app/mcp.
  2. Run an authenticated tool (for example: get_account).
  3. Click Authenticate when prompted by your MCP client.
  4. Complete authorization in your browser (sign in if required, select account, approve access).
  5. Return to your MCP client and retry the request.
tip

Without authentication, you can still use public tools like get_discoverable_promotions.

Manual API token fallback​

If your MCP client does not support OAuth prompts yet, you can authenticate by adding a ValueMapper API token manually.

Getting an API Token​

  1. Log in to your ValueMapper account
  2. Navigate to Account Settings
  3. Under API Tokens, click Create Token
  4. Copy the generated token (it will only be shown once)

Adding Authentication to Your Configuration​

Claude Code:

claude mcp add --transport http valuemapper https://mcp.valuemapper.app/mcp \
  --header "Authorization: Bearer YOUR_API_TOKEN"

Cursor / VS Code / Windsurf / Other tools:

{
  "mcpServers": {
    "valuemapper": {
      "url": "https://mcp.valuemapper.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
caution

Keep your API token secure. Do not commit it to version control or share it publicly.

FAQ​

Does ValueMapper MCP require authentication?

Public tools like get_discoverable_promotions work without authentication. Account-specific tools like get_account and get_promotions require authentication through OAuth in supported MCP clients.

If your MCP client does not support OAuth prompts yet, configure a ValueMapper API token manually using the Authorization: Bearer header.

Why didn't my MCP client open a browser for authentication?

Your MCP client may not support OAuth prompts yet, or OAuth may be disabled in your MCP client configuration. In that case, use the manual API token fallback above.