marketo_delete_lead

Remove a lead from Marketo by specifying the lead ID to manage your CRM data and maintain clean records.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`leadId`	Yes

Implementation Reference

src/index.ts:497-517 (registration)

Registration of the 'marketo_delete_lead' MCP tool, including inline input schema (leadId: z.number()) and handler function that performs a POST request to the Marketo API endpoint `/rest/v1/leads/${leadId}/delete.json` using the shared makeApiRequest helper.

server.tool(
  'marketo_delete_lead',
  {
    leadId: z.number(),
  },
  async ({ leadId }) => {
    try {
      const response = await makeApiRequest(`/rest/v1/leads/${leadId}/delete.json`, 'POST');

      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:502-516 (handler)

The core handler logic for executing the marketo_delete_lead tool: authenticates via token, sends POST to delete endpoint, returns JSON response or error message.

async ({ leadId }) => {
  try {
    const response = await makeApiRequest(`/rest/v1/leads/${leadId}/delete.json`, 'POST');

    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:499-501 (schema)
Zod input schema defining the required 'leadId' parameter as a number.
```
{
  leadId: z.number(),
},
```

src/index.ts:22-52 (helper)

Shared helper function makeApiRequest used by all Marketo tools, including marketo_delete_lead, to handle authenticated API calls with axios, token management, and error handling.

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;
  }
}

Marketo MCP Server