list_forms
Retrieve all forms from your Tally workspace to view and manage your form collection directly through AI conversation.
Instructions
List all forms in the workspace
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/form_retrieval_tool.ts:22-25 (handler)The core handler function for the 'list_forms' tool. It logs the input arguments and delegates to TallyApiService.getForms() to retrieve the list of forms.
public async execute(args: FormRetrievalArgs): Promise<TallyFormsResponse> { console.log(`Executing form retrieval tool with args: ${JSON.stringify(args)}`); return this.tallyApiService.getForms(args); } - TypeScript interface defining the input parameters for the list_forms tool handler (page, limit, workspaceId).
export interface FormRetrievalArgs { page?: number; limit?: number; workspaceId?: string; } - src/server.ts:1283-1292 (registration)Instantiates the FormRetrievalTool class (as 'form_retrieval') along with other tools, using TallyApiClientConfig.
workspaceManagement: new WorkspaceManagementTool(apiClientConfig), template: new TemplateTool(), form_creation: new FormCreationTool(apiClientConfig), form_modification: new FormModificationTool(apiClientConfig), form_retrieval: new FormRetrievalTool(apiClientConfig), form_sharing: new FormSharingTool(tallyApiClient), form_permissions: new FormPermissionManager(apiClientConfig), submission_analysis: new SubmissionAnalysisTool(apiClientConfig), diagnostic: new DiagnosticTool(), }; - src/server.ts:1608-1627 (registration)Registers/dispatches the 'list_forms' tool call by invoking this.tools.form_retrieval.execute() and formatting the response as MCP content.
case 'list_forms': if (this.tools?.form_retrieval) { const forms = await this.tools.form_retrieval.execute(args || {}); return { content: [ { type: 'text', text: JSON.stringify(forms, null, 2) } ] }; } return { content: [ { type: 'text', text: 'Form retrieval functionality is not implemented' } ] }; - src/server.ts:1424-1433 (schema)JSON Schema definition for the 'list_forms' tool exposed via MCP tools/list endpoint (uses limit/offset pagination).
name: 'list_forms', description: 'List all forms in the authenticated user\'s Tally account', inputSchema: { type: 'object', properties: { limit: { type: 'number', description: 'Maximum number of forms to return', minimum: 1, maximum: 100 }, offset: { type: 'number', description: 'Number of forms to skip for pagination', minimum: 0 } } } },