Set Up Poll MCP in Claude Desktop

Connect Claude Desktop to Poll with the official MCP package and limited token scopes.

Before you start

Install Claude Desktop and Node.js 18 or a later LTS release. The configuration uses npx to start @solworks/poll-mcp.

Create a token

Open Poll settings and select Developer. Create a Personal Access Token. Start with the read scope. Add a write scope only when Claude must do that type of action. Copy the token when Poll shows it.

Add the server

On macOS, edit ~/Library/Application Support/Claude/claude_desktop_config.json. Add the following server. Replace the example token with your token.

claude_desktop_config.json
{
  "mcpServers": {
    "pollfun": {
      "command": "npx",
      "args": ["-y", "@solworks/poll-mcp"],
      "env": {
        "POLL_API_TOKEN": "polld_xxxxx"
      }
    }
  }
}

Keep valid JSON if the file already has other MCP servers. Do not commit this file or share the token.

Restart and test

  1. Quit Claude Desktop completely.
  2. Open Claude Desktop again.
  3. Open the tools menu and confirm that Poll tools are present.
  4. Ask Claude to list trending bets. This tests read access without a write action.

Troubleshooting

  • If the server does not start, run node --version and npx --version in a terminal.
  • If Claude reports invalid JSON, check commas and brackets in the configuration file.
  • If a tool is denied, check the token scope in Poll settings.
  • If the token is exposed, revoke it in Poll settings and create a new token.

See the Poll MCP server reference for all tools, resources, and prompts.