delete_meta_campaign
Permanently remove a Meta campaign and all associated ad sets and ads. This action cannot be undone, so use it to completely delete campaigns rather than temporarily pausing them.
Instructions
Permanently delete a Meta campaign and all its ad sets and ads. Cannot be undone. Use pause_meta_campaign to stop spending temporarily. Requires Starter plan or higher.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| campaign_id | Yes | Meta campaign ID to permanently delete. |
Implementation Reference
- src/index.ts:501-507 (handler)Handler logic for 'delete_meta_campaign' tool. It checks the license, validates the campaign_id, calls the helper `metaDelete` to perform the API request, and returns the success status.
case 'delete_meta_campaign': { const denied = licenseCheck('meta'); if (denied) return fail(denied); if (!args.campaign_id) return fail('campaign_id required.'); await metaDelete(`/${args.campaign_id}`); return ok({ success: true, campaign_id: args.campaign_id, message: 'Campaign permanently deleted.' }); } - src/index.ts:287-294 (schema)MCP tool definition for 'delete_meta_campaign' including description and input schema.
name: 'delete_meta_campaign', description: 'Permanently delete a Meta campaign and all its ad sets and ads. Cannot be undone. Use pause_meta_campaign to stop spending temporarily. Requires Starter plan or higher.', inputSchema: { type: 'object', properties: { campaign_id: { type: 'string', description: 'Meta campaign ID to permanently delete.' } }, required: ['campaign_id'], }, }, - src/index.ts:169-176 (helper)Helper function to perform DELETE requests against the Meta API. Used by the 'delete_meta_campaign' handler.
async function metaDelete(path: string): Promise<MetaApiResponse> { const url = new URL(`${META_API}${path}`); url.searchParams.set('access_token', cfg.metaToken()); const response = await fetch(url.toString(), { method: 'DELETE' }); const json = await response.json() as MetaApiResponse; if (json.error) throw new Error(`Meta API: ${json.error.message} (code ${json.error.code})`); return json; }