Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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.

Prerequisite: get your Zigpoll API key

  1. Log into your Zigpoll dashboard.

  2. Go to Settings → Manage Integrations.

  3. Scroll to API Key, click Add Key under Private Keys, label it "Codex", and copy it.

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. Paste the API key from the prerequisite step on the Zigpoll authorization page and click Authorize. Codex stores a secure token, so you only do this once.

mcp.zigpoll.com authenticates through a browser-based OAuth flow. 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.

  • Authentication errors — re-run codex mcp login zigpoll with a valid API key that hasn't been revoked. Regenerate one from Settings → Manage Integrations → API Key if needed.

Last updated