AskOne MCP server: live Q&A and polls for your agent

The AskOne MCP server lets an AI agent run your organization's live audience Q&A and polls: start a room, add and launch a poll, approve or hide waiting questions, mark questions answered, close the room, and afterwards read the questions as a FAQ draft and the poll results. It cannot ask questions or vote: those are the audience's, and an agent that could would be stuffing the queue and the ranking. Nothing can be deleted through it.

AskOne is live Q&A and polling for talks, webinars, classes and meetings. Your audience joins from a link or QR code on their phones, with no account and no app, asks questions anonymously, upvotes, and answers polls. AI moderation is free on every plan: it screens every question before it reaches the room, so nothing hostile lands on the wall. It runs in the browser, in Zoom, in Google Meet and in ChatGPT.

Use it hosted at https://askone.org/api/mcp (nothing to install; sign in with your AskOne account or use an API token), or run this open-source server locally with npx -y askone-mcp (MIT). It is listed in the official MCP Registry as io.github.phuryn/askone.

Connect

Sign in: no token to handle

Add https://askone.org/api/mcp to an MCP client that supports signing in (OAuth), such as a custom connector in Claude, then sign in with your AskOne account and choose the organization. You must be an administrator of it, and it must already have an AskOne dashboard (if you have just created it, open its dashboard once first). The connection can read and change that organization's rooms; a moderator who signs in is refused, and someone who stops being an administrator loses the connection at their next request.

Claude Code: add the server, then run /mcp and choose askone to sign in:

claude mcp add --transport http askone https://askone.org/api/mcp

With an API token

The hosted server also takes an API token, and the local package needs one. An organization admin creates one in AskOne: open the organization switcher, choose Manage, then API tokens. A token can read every room in that organization, including pending questions and private poll results, and change its rooms, so treat it like a password and keep it out of shared configuration. Tokens created before the host actions shipped (October 2026) can only read; to use the host actions, create a new token and revoke the old one.

The commands below read the token from ASKONE_API_TOKEN. Set it with a prompt, so it stays out of your shell history, and give the client only the variable's name in single quotes, so the shell never expands the token into a command's arguments:

read -rsp 'AskOne API token: ' ASKONE_API_TOKEN; echo; export ASKONE_API_TOKEN

Hosted

The endpoint is https://askone.org/api/mcp (Streamable HTTP), with the header Authorization: Bearer <token>.

Claude Code:

claude mcp add --transport http askone https://askone.org/api/mcp \
  --scope project --header 'Authorization: Bearer ${ASKONE_API_TOKEN}'

This and the local command below write .mcp.json holding only the variable's name; Claude Code fills in the value from your environment when it starts, and the file is safe to commit.

Local: the askone-mcp package (Node.js 20.3+)

Claude Code:

claude mcp add --scope project askone -e 'ASKONE_API_TOKEN=${ASKONE_API_TOKEN}' -- npx -y askone-mcp

Claude Desktop: download askone.mcpb from the latest release and open it. Desktop asks for the token and stores it as a secret.

Cursor, Windsurf, Cline and other clients that take a JSON configuration:

{
  "mcpServers": {
    "askone": {
      "command": "npx",
      "args": ["-y", "askone-mcp"],
      "env": { "ASKONE_API_TOKEN": "your-token" }
    }
  }
}

To run it straight from this repository instead of npm (needs Git): npx -y github:phuryn/askone#v1.2.3.

For a self-hosted AskOne, also set ASKONE_URL to its address (https only).

Agent skill and Claude Code plugin

The askone skill teaches an agent to host a session end to end: prepare the room and its polls, open it, moderate, launch each poll when its topic comes up, mark questions answered, then close the room and write the FAQ and the report. It lives in skills/askone.

• Any agent (Claude Code, Codex, Cursor and others): npx skills add phuryn/askone
• Claude Code plugin, the skill and the hosted server in one install: /plugin install askone --marketplace phuryn/askone (Claude Code 2.1.275 or later; on older versions, /plugin marketplace add phuryn/askone, then /plugin install askone@askone). Then run /mcp, choose askone and sign in.

For the method behind a good Q&A or poll on any tool, the free live-qa and live-polls skills in pm-skills use AskOne by default.

Tools

Reading (any token, or signed in):

This is the beginning of the README. Read the rest at the original. Read the full README ↗