MCP server
Pairpoll serves a stateless Streamable HTTP MCP server at:
https://pairpoll.com/mcp
Claude and ChatGPT apps sign in with OAuth. Developer tools can keep using a Pairpoll API key as a bearer token.
Claude and ChatGPT apps
Add https://pairpoll.com/mcp as a custom connector or remote MCP server. Choose Pairpoll’s detected OAuth sign-in and the client’s published identity or automatic registration. Pairpoll sends you to the existing email one-time-link sign-in, then shows the app name and where it will return. Approve it to connect.
The app can create and manage polls and read results in your Pairpoll account. Disconnect it at Pairpoll → API keys → Connected apps.
Chat apps cannot pass attached images or videos to connectors. When a tool returns an upload link, open it and add the files in your browser. Pairpoll does not fetch files from URLs.
Claude Code
export PAIRPOLL_API_URL=https://pairpoll.com
export PAIRPOLL_API_KEY=ppk_your_key
claude mcp add --transport http pairpoll "$PAIRPOLL_API_URL/mcp" \
--header "Authorization: Bearer $PAIRPOLL_API_KEY"
Run claude mcp get pairpoll to check it.
Codex
export PAIRPOLL_API_URL=https://pairpoll.com
export PAIRPOLL_API_KEY=ppk_your_key
codex mcp add pairpoll \
--url "$PAIRPOLL_API_URL/mcp" \
--bearer-token-env-var PAIRPOLL_API_KEY
Run codex mcp list to check it.
Cursor
Add this to ~/.cursor/mcp.json, or to .cursor/mcp.json for one project:
{
"mcpServers": {
"pairpoll": {
"url": "${env:PAIRPOLL_API_URL}/mcp",
"headers": {
"Authorization": "Bearer ${env:PAIRPOLL_API_KEY}"
}
}
}
}
Restart Cursor after changing the environment variable or config.
Tools
create_pollcreates an empty image or video draft.get_upload_linkchecks that you own a draft and returns its browser upload page.open_pollopens a ready draft and returns the voter share link.close_pollcloses voting. This is final.get_resultsreturns the overall ranking and voter runs.list_pollslists your unexpired polls.delete_voterremoves one voter result without freeing a voter place.delete_polldenies access and queues the poll data and files for deletion.
The tool descriptions include each input and lifecycle rule. Results are also returned as structured data.
File uploads
The server does not fetch files from URLs. Use get_upload_link and add the local files in your browser. Claude and ChatGPT chat apps cannot pass their attachments to Pairpoll.
For what an assistant can do with Pairpoll, in plain words, see Let your AI assistant run the poll.
For local API-key testing, set PAIRPOLL_API_URL=http://localhost:4321. OAuth-capable clients need the public HTTPS endpoint.