convez.ai
MCP ServerIntegração & APIsIntermediário
Poltio

Poltio MCP Server

Poltio/poltio-mcp-server

Acesse Poltio direto do Claude e Gemini via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe a plataforma de gestão de conteúdo Poltio como ferramentas acessíveis por IA. Permite criar, gerenciar e publicar polls, quizzes e testes através de Claude, Gemini ou qualquer cliente compatível com MCP.

Instalação

$npx convez-ai Poltio/poltio-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 2 dias
Versão
v0.4.6
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar e gerenciar polls e quizzes programaticamente
  • Integrar pesquisas em fluxos de automação com Claude
  • Publicar e duplicar conteúdo Poltio em massa
  • Analisar resultados de votações e testes automaticamente

Veredito

MCP server bem estruturado em Go que bridgeia Poltio com IA conversacional. Implementação sólida com suporte a múltiplos clientes (Claude, Gemini) e modos de operação (stdio/HTTP), ideal para automação de conteúdo interativo.

README

A tradução para o português deste README ainda está na fila.

Poltio MCP Server

MCP server that exposes Poltio platform content management as AI-accessible tools. Works with Claude Desktop, Gemini, and any MCP-compatible client.

Prerequisites

  • Go 1.21+
  • A Poltio API token (from your account settings)

Build

go build -o poltio-mcp-server .

Configuration

VariableDescription
POLTIO_API_TOKENBearer token — from Poltio account → Settings → Tokens
PORTWhen set, starts an HTTP server on that port instead of stdio

The server automatically fetches your organizations at startup and activates the first one. Use the list_organizations and switch_organization tools to view and change the active organization.

HTTP Mode (for web UIs and Smithery)

Set PORT to start the server as an HTTP/Streamable-HTTP server instead of a stdio process:

POLTIO_API_TOKEN=your-token PORT=8080 ./poltio-mcp-server

The MCP endpoint is available at http://localhost:8080/mcp.

All requests must include Authorization: Bearer <POLTIO_API_TOKEN> — the server rejects anything that doesn't match.

Publishing to Smithery

  1. Deploy the server to any host with a public HTTPS URL (Fly.io, Railway, Render, VPS).
  2. Set POLTIO_API_TOKEN and PORT in the deployment environment.
  3. Go to smithery.ai → Publish → enter your server URL (https://your-host.com/mcp).
  4. Users connecting through Smithery must configure Authorization: Bearer <token> in the Smithery connection settings.

Claude Desktop Integration

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "poltio": {
      "command": "/absolute/path/to/poltio-mcp-server",
      "env": {
        "POLTIO_API_TOKEN": "your-token-here"
      }
    }
  }
}

Restart Claude Desktop after saving.

Gemini Integration

Gemini supports MCP servers through Gemini CLI and Google AI Studio extensions.

Gemini CLI

Install the Gemini CLI and add the server to your MCP config (~/.gemini/settings.json):

{
  "mcpServers": {
    "poltio": {
      "command": "/absolute/path/to/poltio-mcp-server",
      "env": {
        "POLTIO_API_TOKEN": "your-token-here"
      }
    }
  }
}

Google AI Studio

  1. Open Google AI Studio → Extensions → Add MCP Server.
  2. Set the binary path and environment variables as above.
  3. Reload AI Studio to activate the tools.

Available Tools

Content

ToolDescription
list_contentList polls/quizzes/tests with pagination, type filter, and search
get_contentGet a single content item with its metrics
get_content_editGet full editable content object including all questions, answers, results, and conditions
create_contentCreate a new poll/quiz/test (starts as draft)
update_contentUpdate title, description, or name of a content item
delete_contentPermanently delete a content item
publish_contentPublish a draft content item
duplicate_contentDuplicate a content item into a new draft
list_draftsList unpublished content items
list_templatesList available Poltio content templates
get_templateGet a single content template with all its data
use_templateClone a content template into a new draft content item
get_content_resultsGet paginated vote results (per-answer counts)
get_content_sessionsGet paginated user sessions
get_content_metricsGet time-series metrics grouped by day/week/month/year
get_vote_sourcesGet paginated vote sources (referring URLs) for a content item
get_sankeyGet Sankey diagram data showing user flow through a content item
get_sankey_usersGet users who took a specific path in the Sankey diagram
get_searchable_fieldsGet all searchable and filterable fields for a searchable content item
get_session_urlsGet session URLs grouped by URL with session counts
upload_imageUpload an image (<= 5 MB; png, jpg, jpeg, gif, or webp) via a local image_path, an image_url, or image_base64; returns a file path for use in content, questions, answers, or results. Prefer image_path/image_url — the server reads the bytes directly instead of passing them through the model

Questions

ToolDescription
add_questionAdd a question to a draft content item
update_questionUpdate an existing question
delete_questionDelete a question
get_question_orderGet current question positions
update_question_orderReorder questions (JSON array of {id,position})
get_content_conditionsList questions that have display conditions
add_question_conditionAdd an answer as a display condition on a question
remove_question_conditionRemove a single answer from a question's conditions
clear_question_conditionsRemove all display conditions from a question
get_question_inputsGet paginated free-text vote inputs for a question

Answers

ToolDescription
add_answerAdd a single answer to a question
add_answers_bulkAdd multiple answers (one per line) in one call
update_answerUpdate an existing answer
delete_answerDelete an answer
clone_answersCopy answers from one question to another
get_answer_orderGet current answer positions
update_answer_orderReorder answers (JSON array of {id,position})

Results (quiz/test outcome screens)

ToolDescription
add_resultAdd a result screen to a quiz or test
update_resultUpdate an existing result screen
delete_resultDelete a result screen
set_answer_result_pointSet score-based point linking an answer to a result

Leads

ToolDescription
list_leadsList lead campaigns for this organization
create_leadCreate a new lead campaign
get_leadGet a single lead campaign by ID
update_leadUpdate a lead campaign
delete_leadDelete a lead campaign
get_lead_inputsGet paginated user inputs submitted through a lead form
get_lead_logsGet paginated activation logs for a lead campaign
get_lead_codesGet paginated coupon codes for a lead campaign
add_lead_codesAdd one or more coupon codes to a lead campaign (one per line)
delete_all_lead_codesRemove all coupon codes from a lead campaign
update_lead_codeUpdate a single coupon code
delete_lead_codeDelete a single coupon code

Lead attachment

ToolDescription
set_content_leadAttach a lead form to a content cover screen
remove_content_leadRemove lead form from a content cover screen
set_question_leadAttach a lead form to all answers of a question
remove_question_leadRemove lead form from a question
set_answer_leadAttach a lead form to a specific answer
remove_answer_leadRemove lead form from a specific answer
set_result_leadAttach a lead form to a result screen
remove_result_leadRemove lead form from a result screen

Pixel Codes

ToolDescription
list_pixel_codesList pixel code snippets for this organization
create_pixel_codeCreate a new pixel code snippet (iframe, img, or script tag HTML)
update_pixel_codeUpdate an existing pixel code snippet
delete_pixel_codeDelete a pixel code snippet
set_content_pixel_codeAttach a pixel code to the cover screen of a content item
remove_content_pixel_codeRemove the pixel code from the cover screen of a content item
set_question_pixel_codeAttach a pixel code to all answers of a question
remove_question_pixel_codeRemove the pixel code from all answers of a question
set_answer_pixel_codeAttach a pixel code to a specific answer
remove_answer_pixel_codeRemove the pixel code from a specific answer
set_result_pixel_codeAttach a pixel code to a result screen (fires on result view)
remove_result_pixel_codeRemove the view pixel code from a result screen
set_result_click_pixel_codeAttach a pixel code to a result screen's click/CTA action
remove_result_click_pixel_codeRemove the click pixel code from a result screen

Themes

ToolDescription
list_themesList themes for this organization
get_default_themeGet the default theme values to use as a base when creating a new theme
get_themeGet a single theme by ID
create_themeCreate a new theme (call get_default_theme first to discover available fields)
update_themeUpdate an existing theme's fields
delete_themeDelete a theme (fails if the theme is currently in use)

Dashboard

ToolDescription
get_dashboardGet account dashboard data including recent content and aggregate counters
get_dashboard_summaryGet most recently active content stat summary
get_dashboard_metricsGet account-wide time-series metrics grouped by period

Sheet Hooks

ToolDescription
list_sheet_hooksList Google Sheet hooks for this organization
create_sheet_hookCreate a new Google Sheet hook to stream votes in real time
get_sheet_hookGet details of a Google Sheet hook
update_sheet_hookUpdate an existing Google Sheet hook
delete_sheet_hookDelete a Google Sheet hook
get_sheet_hook_logsGet execution logs for a Google Sheet hook

Webhooks

ToolDescription
list_webhooksList webhooks for this organization
create_webhookCreate a webhook to receive vote/session data in real time
get_webhookGet details of a webhook
update_webhookUpdate an existing webhook
delete_webhookDelete a webhook
get_webhook_logsGet execution logs for a webhook

Votes & Stats

ToolDescription
get_votersGet paginated list of voters for a content item
get_conversion_time_statsGet conversion time-series stats (account-wide or per content)

Reports

ToolDescription
list_reportsList downloadable report requests
create_reportRequest a new downloadable report (sent to your account email)

Data Sources

ToolDescription
list_data_sourcesList data sources connected to this account
create_data_sourceSubmit a new data source (XML/JSON feed URL) for review
delete_data_sourceRemove a data source submission
add_data_source_noteAdd a note to a data source request
upload_data_sourceUpload a file (JSON, XML, CSV, or TXT) as a new data source

Domains

ToolDescription
list_domainsList custom domains configured for this account
create_domainAdd a new custom domain (requires DNS verification after creation)
update_domainUpdate a custom domain's settings
delete_domainDelete a custom domain

Widgets

ToolDescription
list_widgetsList your existing dynamic widgets
create_widgetCreate a new dynamic widget
get_widgetGet a single dynamic widget
update_widgetUpdate an existing dynamic widget
delete_widgetDelete an existing dynamic widget

Settings

ToolDescription
update_settingsUpdate your account's username, email, or profile photo
update_passwordChange your account password
resend_verificationResend the account email verification link
accept_termsAccept the Poltio terms and conditions
setup_two_factorBegin two-factor authentication setup
verify_two_factorConfirm 2FA setup with a TOTP verification code
disable_two_factorDisable two-factor authentication on the current account
reset_two_factor_recovery_codesRegenerate 2FA recovery codes (existing codes are invalidated)

Conversion Settings

ToolDescription
list_conversion_settingsList conversion tracking URLs defined for this account
create_conversion_settingAdd a new checkout success URL for conversion tracking
update_conversion_settingUpdate an existing conversion tracking URL
delete_conversion_settingDelete a conversion tracking URL

Organizations

ToolDescription
list_organizationsList organizations the current user belongs to, including their role
switch_organizationSwitch the active organization context
get_organizationGet an organization's details including members and pending invites
update_organizationUpdate an organization's name
invite_org_memberInvite a new member to an organization via email
join_organizationJoin an organization using an invite token
leave_organizationLeave an organization (not available to the owner)
cancel_org_inviteCancel a pending organization invitation by email
remove_org_memberRemove a member from an organization
update_org_memberUpdate a member's role in an organization

Subscription

ToolDescription
list_subscription_tiersList available subscription tiers and their features
create_subscriptionCreate a new subscription for the current organization

Utilities

ToolDescription
search_playgroundTest search queries and filters against a searchable content item
check_snippet_pageCheck if a page URL has the Poltio snippet active in the last 48 hours
create_short_linkCreate a polt.io shortened URL from any long URL

Running Tests

go test ./...
Ver o original no GitHub

Bom para

Relacionados