convert_documentLABSCO SUMMARY
A quiz written, revised and exported in the conversation that produced it.
The flow is one sentence per step: create the form, read it back, change the questions you did not like, export it to whatever platform the class uses, publish. Conversion runs as a background job, so a long document returns a job to poll instead of blocking the chat.
What it is
Formswrite's hosted server at https://mcp.formswrite.com/mcp, letting Claude, Cursor or ChatGPT create and manage quizzes and forms in your Formswrite account.
What you get
- convert_document — a Google Doc, PDF or pasted text turned into a form as a background job; create_form to build one from a document or a prompt
- get_form_data to read a form's questions and settings, modify_questions to add, edit or remove them, update_form_metadata for title and description
- export_form — Google Forms, Moodle, Kahoot, Quizizz, Canvas and 25+ formats from the same quiz
- publish_form — open a Formswrite-hosted form to responses
- list_jobs and get_job to follow the background conversion work
Requirements
A Formswrite account and an auth token generated under Settings, which goes into the endpoint URL in place of YOUR_TOKEN (the server also accepts it as an Authorization: Bearer header). Claude Code adds the server in one command, Claude Desktop bridges through mcp-remote, and Cursor and ChatGPT take the URL directly. Every tool acts only on the authenticated user's own forms.
Setup effort
One command plus a key — claude mcp add --transport http formswrite "https://mcp.formswrite.com/mcp?token=<YOUR_TOKEN>", then supply credentials
USE CASES
01
Turning a reading into a quiz
Point it at a Google Doc or PDF and get a form back with the questions detected for you.
02
Building one from nothing
Describe the topic and the reading level, and the questions and right answers are written for you.
03
Revising a quiz that was almost right
Ask for questions to be rewritten, reordered or added, then read the result back.
04
Getting the same quiz into another platform
Export it to Google Forms, Moodle, Kahoot, Quizizz or Canvas without rebuilding it.
05
Opening it to responses
Publish the Formswrite-hosted version once the title and the questions are settled.
9 tools
Listed in project docs. Your client may show a different list.
create_formget_form_datamodify_questionsupdate_form_metadataexport_formpublish_formlist_jobsget_jobBEFORE YOU INSTALL
What to know first
Tools you get
9 tools named in the project's documentation.
Requires
- A client that can reach a remote MCP server over HTTP
- A Formswrite auth token (Settings → Generate Auth Token), placed in the endpoint URL
INSTALLATION
Connect your client
Server setup
claude mcp add
TERMINAL
claude mcp add --transport http formswrite "https://mcp.formswrite.com/mcp?token=<YOUR_TOKEN>"Hosted endpoint
ENDPOINT URL
https://mcp.formswrite.com/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add --transport http formswrite "https://mcp.formswrite.com/mcp?token=<YOUR_TOKEN>"The token goes into the URL, as <YOUR_TOKEN>: in Formswrite, open Settings, click Generate Auth Token and copy it. The token gives full access to your Formswrite account.
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"formswrite": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.formswrite.com/mcp?token=<YOUR_TOKEN>"
]
}
}
}The token goes into the URL, as <YOUR_TOKEN>: in Formswrite, open Settings, click Generate Auth Token and copy it. The token gives full access to your Formswrite account.
