Skip to main content

Connecting to ValueMapper MCP

Connect your AI tool to ValueMapper using MCP. Choose your preferred AI tool below for specific setup instructions.

Claude Code​

Run the following command to add the ValueMapper MCP server:

claude mcp add --transport http valuemapper https://mcp.valuemapper.app/mcp

You can use the --scope flag for different installation scopes:

  • --scope local (default): Available only to you in the current project
  • --scope project: Shared with your team via .mcp.json file
  • --scope user: Available to you across all projects

Verify the connection with /mcp in Claude Code.

Cursor​

Add the following to your MCP settings (Settings → MCP):

{
  "mcpServers": {
    "valuemapper": {
      "url": "https://mcp.valuemapper.app/mcp"
    }
  }
}

For project-level configuration, create .cursor/mcp.json in your project root with the same content.

VS Code (GitHub Copilot)​

Create or edit .vscode/mcp.json in your project:

{
  "servers": {
    "valuemapper": {
      "type": "http",
      "url": "https://mcp.valuemapper.app/mcp"
    }
  }
}

Use Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) to access MCP settings.

Claude Desktop​

  1. Open Claude Desktop settings
  2. Navigate to the MCP servers section
  3. Add a new server with URL: https://mcp.valuemapper.app/mcp

Or edit your claude_desktop_config.json directly:

{
  "mcpServers": {
    "valuemapper": {
      "url": "https://mcp.valuemapper.app/mcp"
    }
  }
}

Windsurf​

  1. Open Settings (Cmd+, on macOS)
  2. Navigate to MCP configuration
  3. Edit mcp_config.json:
{
  "mcpServers": {
    "valuemapper": {
      "serverUrl": "https://mcp.valuemapper.app/mcp"
    }
  }
}

Other Tools​

For tools that support MCP, use the following server URL:

https://mcp.valuemapper.app/mcp

JSON configuration format​

Most MCP clients accept this configuration format:

{
  "mcpServers": {
    "valuemapper": {
      "url": "https://mcp.valuemapper.app/mcp"
    }
  }
}

Tools without remote MCP support​

If your tool doesn't support remote MCP servers, you can use mcp-remote:

{
  "mcpServers": {
    "valuemapper": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.valuemapper.app/mcp"]
    }
  }
}

Troubleshooting​

Connection issues​

  • Ensure your AI tool supports MCP and is properly configured
  • Check that the server URL is correct: https://mcp.valuemapper.app/mcp
  • Try disconnecting and reconnecting in your tool's MCP settings

My tool isn't listed here​

If your AI tool supports MCP but isn't listed, try using the generic JSON configuration format above. Most MCP-compatible tools accept similar configuration structures.

Authenticated Access​

Some MCP tools require authentication to access account-specific data.

For OAuth flow steps, browser-auth troubleshooting, and manual API token fallback, see MCP Authentication.

FAQ​

For authentication FAQs, see MCP Authentication.

Can I run the MCP server myself?

The ValueMapper MCP server is a hosted service only. Self-hosting is not supported.