MCP server & authoring API
Build surveys with your AI agent.
Connect Claude, Cursor, or Copilot to Answerama. Plan studies, generate 14 question types, and write drafts straight into your workspace.
- checkMCP server & API keys on every plan
- checkAnswerama Markdown on every plan
- checkIn-app AI generation on Pro
The problem
Authoring good questions is slow
Turning a research goal into a well-structured survey means picking question types, writing clear prompts, and balancing scales by hand. Your AI tools sit in another tab, disconnected from where the work lands.
The solution
Loop your agent into the project
Answerama exposes a remote MCP server and a REST authoring API. Your agent plans the study, generates validated questions, and writes them into a draft project — you stay in control and publish when it's right.
Two ways to generate
Use Answerama's built-in generator, or bring your own agent over MCP.
Generate with AI in-app
Describe your goal in a sentence and Answerama drafts a complete survey for you to refine. Available on Pro.
Remote MCP server
A standards-based Model Context Protocol server your agent connects to over Streamable HTTP. Works with Claude Desktop, Cursor, and more.
Plan before you build
The plan_survey tool turns a brief into a structured outline, so you can review the approach before any content is written.
14 question types
Multiple choice, Likert, ranking, matrix, word cloud, SWOT, Kano, 2×2 quadrant, and more — generated with valid options and config.
Drafts, not surprises
Everything an agent writes lands as a draft project. Revise conversationally, then decide when it goes live.
Scoped API keys
Issue and revoke Answerama API keys from Settings. Keys grant authoring access only and are shown once.
How it works
Three steps from a key to a ready-to-review draft.
-
01
Create an API key
In Answerama, open Settings → Developer and create a key. Copy it once and add it to your agent's config.
-
02
Connect over MCP
Point Claude, Cursor, or any MCP client at the Answerama server URL with your key. The Answerama tools appear automatically.
-
03
Plan, generate, review
Ask your agent to plan and write a survey. It creates a draft project; you review, revise, and publish in Answerama.
Connect in two minutes
Add the Answerama MCP server to your client config. Here's an example for Claude Desktop using mcp-remote.
Prefer raw HTTP? The same actions are available on the REST authoring API. Generate a key in Settings → Developer to get started.
{
"mcpServers": {
"answerama": {
"command": "npx",
"args": [
"mcp-remote",
"https://answerama-mcp.riojascesar3.workers.dev/mcp",
"--header",
"Authorization: Bearer ak_live_your_key_here"
]
}
}
}
Tools your agent gets
A focused toolset for planning and authoring — nothing that can publish or delete on its own.
list_question_types
Discover supported, authorable question types.
list_projects
See the projects in your account.
get_project
Read a project and its current questions.
plan_survey
Turn a brief into a structured outline.
generate_survey
Create a draft project with full questions.
add_questions
Append generated questions to a project you own.
revise_questions
Refine a draft from natural-language feedback.
create_survey_from_markdown
Write questions as .answer.md — including “if yes, then…” follow-ups — and save them as a draft. Free on every plan.
validate_markdown
Check a document and get line-numbered fixes before importing.
export_project_markdown
Read any project as compact, editable text.
Want a walkthrough?
Leave your email and we'll send setup docs for the MCP server and authoring API, plus tips for getting the most out of agentic authoring.
Put your AI agent to work.
Connect your agent free and write question sets in Answerama Markdown, or generate them in-app with AI on Pro.