Connect to Codex

Connect Zigpoll to the OpenAI Codex CLI as an MCP server to analyze survey data and create surveys from your terminal.

Connect your Zigpoll surveys to the OpenAI Codex CLI as an MCP server using the Model Context Protocol (MCP). Once connected, Codex can read your survey responses, run analytics, and create surveys — straight from your terminal.

For other AI clients, see the MCP overview.

Plan requirement: MCP uses the Zigpoll API, which is included on the Premium plan and higher.

Connecting to a remote MCP server over HTTP requires a recent version of the Codex CLI (with streamable HTTP support). Update Codex if the steps below don't match your version.

Step 1: Add Zigpoll to your Codex config

Open ~/.codex/config.toml and add a server entry:

[mcp_servers.zigpoll]
url = "https://mcp.zigpoll.com/mcp"

Step 2: Authenticate

Run the OAuth login from your terminal:

codex mcp login zigpoll

A browser window opens to authorize with Zigpoll. If you're already logged into Zigpoll in that browser, authorization completes automatically — you'll briefly see a loading screen, then be returned to Codex. If you're not logged in, sign in with your email and password, Google, or Shopify. Codex stores a secure token, so you only do this once.

mcp.zigpoll.com authenticates through a browser-based OAuth flow tied to your Zigpoll account, so there's no API key to copy or paste. A static bearer_token / Authorization header will not work. Use codex mcp login as shown above.

Step 3: Verify your connection

Start Codex and ask:

"List my Zigpoll accounts"

Codex will use the Zigpoll tools automatically to fetch your data.

Example prompts

• "Summarize the responses for my NPS survey from the last 30 days"

• "What are the daily response trends for my customer satisfaction survey?"

• "Correlate my NPS scores with purchase type"

• "Create a new NPS survey for my account"

For the full list of tools and more examples, see the MCP overview. For ideas on what to build, see Ideas for Using Zigpoll MCP.

Troubleshooting

• Server not connecting — confirm your Codex version supports remote (streamable HTTP) MCP servers, and that the url in config.toml is exactly https://mcp.zigpoll.com/mcp.

• Connected to the wrong Zigpoll account — authorization uses whichever Zigpoll login is signed in to your browser. Log in as the correct user at app.zigpoll.com, then re-run codex mcp login zigpoll.

• Authentication errors — the connection authenticates with an API key labeled "MCP" that Zigpoll creates automatically. If it was revoked under Integrations → API Keys, re-run codex mcp login zigpoll to issue a new one.

• "This account's plan does not include API access" — the Zigpoll account is on a plan without API access. Upgrade to Premium or higher.