# Tally — MCP server on mcp.ai
> Connect your Tally account and use 18 tools for forms and surveys straight from your AI agent. Connect with your own API key. Tally is a form-building platform that allows users to create forms, collect responses, and integrate with various tools and services.

By: mcp.ai · official
Page: https://mcp.ai/tally

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_tally?ms=1787293620000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/tally/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/tally/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/tally/skill.md
Postman collection (v2.1): https://mcp.ai/tally/postman.json

## Tools
- tally_create_form(title?: string, blocks: object[], status: string, settings?: object, templateId?: string, workspaceId?: string) — Tool to create a new form. Use after preparing block definitions and optional settings.
- tally_create_webhook(url: string, formId: string, eventTypes?: string[], httpHeaders?: object[], signingSecret?: string, externalSubscriber?: string) — Tool to create a new webhook for a form. Use after confirming you have the form ID and the callback URL.
- tally_delete_form(formId: string) — Tool to delete a specific form identified by its ID. Use after confirming the form should be permanently removed.
- tally_delete_webhook(webhookId: string) — Tool to delete a specific webhook. Use after confirming the webhook ID.
- tally_get_form_details(formId: string) — Tool to retrieve details of a specific form. Use when you need comprehensive form metadata by ID. Use after confirming the form ID to fetch its full configuration, blocks, and stats.
- tally_get_form_responses(page?: integer, limit?: integer, formId: string) — Tool to retrieve the responses of a specific form. Use after confirming the form ID and when paginated data is needed.
- tally_get_user_info() — Tool to retrieve information about the authenticated user. Use when you need to confirm account-level details before proceeding. Returns account/workspace context only — not form-level access; follow 
- tally_get_webhook_events(page?: integer, webhookId: string) — Tool to list events associated with a specific webhook. Use when you need to inspect delivery history after creating or listing a webhook.
- tally_get_workspace(workspaceId: string) — Tool to retrieve a single workspace by its ID with associated members. Use when you need to get detailed information about a specific workspace.
- tally_list_form_questions(formId: string) — Tool to retrieve all questions from a specific form. Use when you need to list all questions and their structure after obtaining the form ID.
- tally_list_forms(page?: integer) — Tool to retrieve a paginated list of forms. Use when you need to list all forms accessible to the authenticated user.
- tally_list_organization_invites(organizationId: string) — Tool to retrieve all pending invites in your organization. Use when you need to view or manage organization invitation status.
- tally_list_organization_users(organizationId: string) — Tool to retrieve all users in an organization. Use when you need to list organization members or check user permissions.
- tally_list_webhooks(page?: integer, limit?: integer) — Tool to retrieve a paginated list of configured webhooks. Use when you need a full listing of webhooks across your accessible forms and workspaces.
- tally_list_workspaces(page?: integer) — Tool to retrieve a paginated list of workspaces. Use when you need to browse workspaces accessible to the authenticated user.
- tally_update_form(name?: string, blocks?: object[], formId: string, status?: string, settings?: object) — Tool to update form details. Use after confirming the form exists and obtaining its ID.
- tally_update_webhook(url: string, formId: string, isEnabled: boolean, webhookId: string, eventTypes: string[], httpHeaders?: object[], signingSecret?: string) — Tool to update an existing webhook configuration. Use when you need to modify webhook settings such as URL, event types, or enable/disable status.
- tally_update_workspace(name?: string, workspaceId: string) — Tool to update the details of a specific workspace identified by its ID. Use when you need to rename a workspace after confirming the workspace ID.

## Example prompts
- "What can I do in Tally?"
- "Show me a summary of my Tally account"

## Links
Docs: https://mcp.ai/docs/mcps/tally
Website: https://mcp.ai/mcps/tally