{
  "markdown": "# Formester MCP Server\n\nGive your AI agent access to form submissions — read responses, query across forms, write insights back, and process file attachments.\n\n**Endpoint:** `https://app.formester.com/mcp`\n\n```\nAvailable tools: read_submission · query_submissions · update_submission · fetch_file\n```\n\n---\n\n## Quickstart\n\n**Step 1: Choose your auth method**\n\n| Method | Best for |\n|--------|---------|\n| **OAuth** | Interactive clients (Claude.ai, Cursor, VS Code) — authorize via browser, no token setup |\n| **API Token** | Scripts, automation, or clients without OAuth support — create once in Formester → API |\n\n→ [Full authentication guide](docs/authentication.md)\n\n**Step 2: Connect your AI client**\n\n---\n\n### Claude\n\n**Via OAuth (recommended)**\n\nSettings → Connectors → Add custom connector → enter a name and `https://app.formester.com/mcp` as the URL. Claude will prompt you to authorize on first connection.\n\n**Via API Token**\n\n```json\n{\n  \"mcpServers\": {\n    \"formester\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"https://app.formester.com/mcp\",\n        \"--header\",\n        \"Authorization: Bearer YOUR_TOKEN_HERE\"\n      ]\n    }\n  }\n}\n```\n\nFully quit and restart Claude Desktop.\n---\n\n### VS Code (GitHub Copilot)\n\n**Via OAuth**\n\nCreate or edit `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"formester\": {\n      \"type\": \"http\",\n      \"url\": \"https://app.formester.com/mcp\"\n    }\n  }\n}\n```\n\nVS Code will handle the OAuth flow automatically. Switch Copilot Chat to **Agent mode** to use the tools.\n\n**Via API Token**\n\n```json\n{\n  \"servers\": {\n    \"formester\": {\n      \"type\": \"http\",\n      \"url\": \"https://app.formester.com/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_TOKEN_HERE\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### Cursor\n\n**Via OAuth**\n\nSettings → MCP → Add new MCP server:\n\n```json\n{\n  \"mcpServers\": {\n    \"formester\": {\n      \"url\": \"https://app.formester.com/mcp\"\n    }\n  }\n}\n```\n\nCursor will prompt you to authorize via browser on first use.\n\n**Via API Token**\n\n```json\n{\n  \"mcpServers\": {\n    \"formester\": {\n      \"url\": \"https://app.formester.com/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_TOKEN_HERE\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### Claude Code\n\n**Via OAuth**\n\n```bash\nclaude mcp add --transport http formester https://app.formester.com/mcp\n```\n\n**Via API Token**\n\n```bash\nclaude mcp add --transport http formester https://app.formester.com/mcp \\\n  --header \"Authorization: Bearer YOUR_TOKEN_HERE\"\n```\n\n---\n\n### Windsurf\n\n**Via OAuth**\n\nEdit `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"formester\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://app.formester.com/mcp\"\n    }\n  }\n}\n```\n\n**Via API Token**\n\n```json\n{\n  \"mcpServers\": {\n    \"formester\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://app.formester.com/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_TOKEN_HERE\"\n      }\n    }\n  }\n}\n```\n\nRestart Windsurf after saving.\n\n---\n\n## Example prompts\n\n**Summarize a support ticket**\n```\nRead submission a1b2c3d4 and summarize the issue reported.\n```\n\n**Triage a contact form**\n```\nRead the last 20 submissions for form xyz, classify each one as 'sales', 'support', or 'other'\nbased on the message content, and save the category as a custom field called 'ai_category'.\n```\n\n**Review a job application**\n```\nRead submission a1b2c3d4 with files included. Fetch the resume PDF, extract the candidate's\nskills and years of experience, and write a brief evaluation back as 'ai_evaluation'.\n```\n\n**Process a batch of applications**\n```\nQuery all submissions for form xyz from the past 7 days. For each one, fetch the attached CV,\nextract the applicant's name, role applied for, and top 3 skills, then save them as custom fields.\n```\n\n**Flag urgent issues**\n```\nGet the last 50 submissions for form xyz. Identify any that mention billing problems or account\naccess issues, mark them as starred, and set a custom field 'ai_priority' to 'urgent'.\n```\n\n---\n\n## Docs\n\n- [Authentication](docs/authentication.md) — OAuth, API tokens, scopes\n- [Tools](docs/tools.md) — full reference for all 4 tools with parameters and response shapes\n- [Troubleshooting](docs/troubleshooting.md) — common errors and fixes\n\n---\n\n## Links\n\n- [Formester](https://formester.com)\n- [Documentation](https://docs.formester.com)\n- [Support](https://formester.com/contact)\n",
  "bytes": 4391,
  "sha": "7b0e85229e5cb95124ff87293e1a1c519c06e6e85a0aaa7610bd4d8806b9eb9a",
  "repo_slug": "formester/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_formester_mcp_63aa9470/readme"
}