SurveyMonkey MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on SurveyMonkey: 13 typed functions through one MCP server. No SurveyMonkey API key needed.
- Site
- surveymonkey.com
- Functions
- 13
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for SurveyMonkey alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/surveymonkeyOne MCP server for SurveyMonkey and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
getAccountInfoRetrieves the signed-in user's account details: name, email, plan tier, response limits.Arguments
None.
Returns
SurveyMonkeyAccountinterface SurveyMonkeyAccount { id: string | null; username: string | null; email: string | null; firstName: string | null; lastName: string | null; packageId: string | null; language: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/surveymonkey/getAccountInfoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.surveymonkey.getAccountInfo();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.surveymonkey.getAccountInfo())curl -X POST https://api.bowmark.ai/v1/sites/surveymonkey/getAccountInfo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.surveymonkey.getAccountInfo();getCollectorStatusRetrieves the response count and status for one collector on one survey.Arguments
Name Type Required collectorIdstringYes Returns
SurveyMonkeyCollectorinterface SurveyMonkeyCollector { id: string; name: string | null; type: string | null; status: string | null; // the site's own labels, read the values off a result, never guess one from prose responseCount: number | null; createdAt: string | null; modifiedAt: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/surveymonkey/getCollectorStatusCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.surveymonkey.getCollectorStatus({ collectorId: "1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.surveymonkey.getCollectorStatus({"collectorId": "1"}))curl -X POST https://api.bowmark.ai/v1/sites/surveymonkey/getCollectorStatus \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"collectorId":"1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.surveymonkey.getCollectorStatus({ collectorId: "1" });getSurveyRetrieves one survey's full details: title, description, questions, and settings.Arguments
Name Type Required surveyIdstringYes Returns
SurveyMonkeySurveyDetailinterface SurveyMonkeySurvey { id: string; title: string | null; nickname: string | null; status: string | null; // the site's own labels, read the values off a result, never guess one from prose createdAt: string | null; modifiedAt: string | null; questionCount: number | null; } interface SurveyMonkeySurveyDetail extends SurveyMonkeySurvey { questions: { id: string; position: number | null }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/surveymonkey/getSurveyCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.surveymonkey.getSurvey({ surveyId: "1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.surveymonkey.getSurvey({"surveyId": "1"}))curl -X POST https://api.bowmark.ai/v1/sites/surveymonkey/getSurvey \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"surveyId":"1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.surveymonkey.getSurvey({ surveyId: "1" });getSurveyResultsFetches all responses submitted to one survey, with respondent answers per question.Arguments
Name Type Required surveyIdstringYes pagenumberNo pageSizenumberUp to 100, default 25.No Returns
SurveyMonkeySurveyResultsinterface SurveyMonkeyRespondent { id: string; status: string | null; // the site's own labels, read the values off a result, never guess one from prose email: string | null; firstName: string | null; lastName: string | null; ipAddress: string | null; startedAt: string | null; collectorId: string | null; } interface SurveyMonkeySurveyResults { surveyId: string; totalResponses: number | null; totalCount: number; // respondents across every page respondents: SurveyMonkeyRespondent[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/surveymonkey/getSurveyResultsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.surveymonkey.getSurveyResults({ surveyId: "1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.surveymonkey.getSurveyResults({"surveyId": "1"}))curl -X POST https://api.bowmark.ai/v1/sites/surveymonkey/getSurveyResults \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"surveyId":"1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.surveymonkey.getSurveyResults({ surveyId: "1" });listCollectorsLists all collectors (email, link, SMS, etc.) set up for one survey with response counts.Arguments
Name Type Required surveyIdstringYes Returns
SurveyMonkeyCollector[]interface SurveyMonkeyCollector { id: string; name: string | null; type: string | null; status: string | null; // the site's own labels, read the values off a result, never guess one from prose responseCount: number | null; createdAt: string | null; modifiedAt: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/surveymonkey/listCollectorsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.surveymonkey.listCollectors({ surveyId: "1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.surveymonkey.listCollectors({"surveyId": "1"}))curl -X POST https://api.bowmark.ai/v1/sites/surveymonkey/listCollectors \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"surveyId":"1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.surveymonkey.listCollectors({ surveyId: "1" });listSurveysLists the signed-in user's surveys with titles, creation dates, and response counts.Arguments
Name Type Required pagenumberNo pageSizenumberNo sortBy"modified" | "title" | "responses"No Returns
SurveyMonkeySurveyListinterface SurveyMonkeySurvey { id: string; title: string | null; nickname: string | null; status: string | null; // the site's own labels, read the values off a result, never guess one from prose createdAt: string | null; modifiedAt: string | null; questionCount: number | null; } interface SurveyMonkeySurveyList { totalCount: number; surveys: SurveyMonkeySurvey[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/surveymonkey/listSurveysCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.surveymonkey.listSurveys({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.surveymonkey.listSurveys({}))curl -X POST https://api.bowmark.ai/v1/sites/surveymonkey/listSurveys \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.surveymonkey.listSurveys({});listTemplatesLists pre-built survey templates available to the signed-in user.Arguments
Name Type Required languageIdnumberSurveyMonkey's numeric language id, default 1 (English).No pagenumberNo pageSizenumberNo Returns
SurveyMonkeyTemplateListinterface SurveyMonkeyTemplate { id: string; title: string | null; questionCount: number | null; } interface SurveyMonkeyTemplateList { totalCount: number; templates: SurveyMonkeyTemplate[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/surveymonkey/listTemplatesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.surveymonkey.listTemplates({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.surveymonkey.listTemplates({}))curl -X POST https://api.bowmark.ai/v1/sites/surveymonkey/listTemplates \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.surveymonkey.listTemplates({});
createCollectorCreates a new collector (web link, email invite, SMS, or social) to distribute one survey.Arguments
Name Type Required surveyIdstringYes type"weblink" | "email" | "sms"Default "weblink".No Returns
SurveyMonkeyCollectorinterface SurveyMonkeyCollector { id: string; name: string | null; type: string | null; status: string | null; // the site's own labels, read the values off a result, never guess one from prose responseCount: number | null; createdAt: string | null; modifiedAt: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/surveymonkey/createCollectorCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.surveymonkey.createCollector({ surveyId: "<surveyId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.surveymonkey.createCollector({"surveyId": "<surveyId>"}))curl -X POST https://api.bowmark.ai/v1/sites/surveymonkey/createCollector \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"surveyId":"<surveyId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.surveymonkey.createCollector({ surveyId: "<surveyId>" });createSurveyCreates a new survey with title, questions, and initial settings.Arguments
Name Type Required titlestringYes Returns
SurveyMonkeySurveyinterface SurveyMonkeySurvey { id: string; title: string | null; nickname: string | null; status: string | null; // the site's own labels, read the values off a result, never guess one from prose createdAt: string | null; modifiedAt: string | null; questionCount: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/surveymonkey/createSurveyCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.surveymonkey.createSurvey({ title: "<title>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.surveymonkey.createSurvey({"title": "<title>"}))curl -X POST https://api.bowmark.ai/v1/sites/surveymonkey/createSurvey \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"title":"<title>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.surveymonkey.createSurvey({ title: "<title>" });deleteCollectorStops collecting responses through one collector on one survey.Arguments
Name Type Required surveyIdstringYes collectorIdstringYes type"weblink" | "email" | "sms"The collector's type from listCollectors, default "weblink".No Returns
SurveyMonkeyDeleteCollectorResultinterface SurveyMonkeyDeleteCollectorResult { collectorId: string; deleted: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/surveymonkey/deleteCollectorCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.surveymonkey.deleteCollector({ surveyId: "<surveyId>", collectorId: "<collectorId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.surveymonkey.deleteCollector({"surveyId": "<surveyId>", "collectorId": "<collectorId>"}))curl -X POST https://api.bowmark.ai/v1/sites/surveymonkey/deleteCollector \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"surveyId":"<surveyId>","collectorId":"<collectorId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.surveymonkey.deleteCollector({ surveyId: "<surveyId>", collectorId: "<collectorId>" });deleteSurveyPermanently deletes one survey and all its responses.Arguments
Name Type Required surveyIdstringYes Returns
SurveyMonkeyDeleteSurveyResultinterface SurveyMonkeyDeleteSurveyResult { surveyId: string; deleted: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/surveymonkey/deleteSurveyCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.surveymonkey.deleteSurvey({ surveyId: "<surveyId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.surveymonkey.deleteSurvey({"surveyId": "<surveyId>"}))curl -X POST https://api.bowmark.ai/v1/sites/surveymonkey/deleteSurvey \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"surveyId":"<surveyId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.surveymonkey.deleteSurvey({ surveyId: "<surveyId>" });editSurveyUpdates an existing survey's title, description, questions, or settings.Arguments
Name Type Required surveyIdstringYes titlestringYes Returns
SurveyMonkeyEditSurveyResultinterface SurveyMonkeyEditSurveyResult { surveyId: string; title: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/surveymonkey/editSurveyCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.surveymonkey.editSurvey({ surveyId: "<surveyId>", title: "<title>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.surveymonkey.editSurvey({"surveyId": "<surveyId>", "title": "<title>"}))curl -X POST https://api.bowmark.ai/v1/sites/surveymonkey/editSurvey \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"surveyId":"<surveyId>","title":"<title>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.surveymonkey.editSurvey({ surveyId: "<surveyId>", title: "<title>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/surveymonkey/<function> - OpenAPI
/v1/sites/surveymonkey/openapi.json