marketo_get_forms
Retrieve Marketo forms with filtering options for status and pagination control to manage form workflows.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| maxReturn | No | ||
| offset | No | ||
| status | No |
Implementation Reference
- src/index.ts:63-86 (handler)The handler function for the 'marketo_get_forms' tool. It constructs query parameters for maxReturn, offset, and optional status filter, makes an authenticated GET request to the Marketo Forms API endpoint, and returns the JSON response or error message.async ({ maxReturn = 200, offset = 0, status }) => { try { const params = new URLSearchParams({ maxReturn: maxReturn.toString(), offset: offset.toString(), }); if (status) { params.append('status', status); } const response = await makeApiRequest(`/asset/v1/forms.json?${params.toString()}`, 'GET'); return { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }], }; } catch (error: any) { return { content: [ { type: 'text', text: `Error: ${error.response?.data?.message || error.message}` }, ], }; } }
- src/index.ts:58-62 (schema)Zod input schema defining optional parameters: maxReturn (number), offset (number), status (enum: 'approved' or 'draft').{ maxReturn: z.number().optional(), offset: z.number().optional(), status: z.enum(['approved', 'draft']).optional(), },
- src/index.ts:56-87 (registration)Registration of the 'marketo_get_forms' tool on the MCP server using server.tool(), including schema and inline handler function.server.tool( 'marketo_get_forms', { maxReturn: z.number().optional(), offset: z.number().optional(), status: z.enum(['approved', 'draft']).optional(), }, async ({ maxReturn = 200, offset = 0, status }) => { try { const params = new URLSearchParams({ maxReturn: maxReturn.toString(), offset: offset.toString(), }); if (status) { params.append('status', status); } const response = await makeApiRequest(`/asset/v1/forms.json?${params.toString()}`, 'GET'); return { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }], }; } catch (error: any) { return { content: [ { type: 'text', text: `Error: ${error.response?.data?.message || error.message}` }, ], }; } } );
- src/index.ts:22-52 (helper)Shared helper function used by the tool to perform authenticated HTTP requests to the Marketo API using axios, handling token retrieval and error logging.async function makeApiRequest( endpoint: string, method: string, data?: any, contentType: string = 'application/json' ) { const token = await tokenManager.getToken(); const headers: any = { Authorization: `Bearer ${token}`, }; if (contentType) { headers['Content-Type'] = contentType; } try { const response = await axios({ url: `${MARKETO_BASE_URL}${endpoint}`, method: method, data: contentType === 'application/x-www-form-urlencoded' ? new URLSearchParams(data).toString() : data, headers, }); return response.data; } catch (error: any) { console.error('API request failed:', error.response?.data || error.message); throw error; } }