Attio MCP Server

Instructions

Implementation Reference

• packages/core/src/tools/handlers.ts:797-818 (handler)

  Core handler function for the delete-record tool. Performs DELETE request to Attio API /v2/objects/{slug}/records/{record_id} using the HttpClient.

  export async function handleDeleteRecord(
    client: HttpClient,
    params: {
      resource_type: ResourceType;
      record_id: string;
    }
  ): Promise<ToolResult> {
    try {
      const { resource_type, record_id } = params;
      const objectSlug = getObjectSlug(resource_type);
  
      await client.delete(`/v2/objects/${objectSlug}/records/${record_id}`);
  
      return structuredResult(
        { record_id },
        `Deleted ${resource_type} record with ID: ${record_id}`
      );
    } catch (error) {
      const { message, details } = extractErrorInfo(error);
      return errorResult(message || 'Failed to delete record', details);
    }
  }

• packages/core/src/tools/definitions.ts:281-304 (schema)

  ToolDefinition for delete-record, including input schema (resource_type and record_id required) and formatted description.

  export const deleteRecordDefinition: ToolDefinition = {
    name: 'delete-record',
    description: formatDescription({
      capability:
        'Delete an Attio record from its object (company, person, deal, task)',
      boundaries:
        'cascade delete related data or clean up list memberships automatically',
      constraints:
        'Requires record_id and resource_type; operation is irreversible once confirmed',
      recoveryHint:
        'If uncertain, fetch with records_get_details to confirm the target before deletion',
    }),
    inputSchema: {
      type: 'object',
      properties: {
        resource_type: RESOURCE_TYPE_SCHEMA,
        record_id: {
          type: 'string',
          description: 'Record ID to delete',
        },
      },
      required: ['resource_type', 'record_id'],
    },
  };

• packages/core/src/tools/handlers.ts:1022-1026 (registration)

  Registration of delete-record handler in the getToolHandler dispatch map.

  'delete-record': async (client, params) =>
    handleDeleteRecord(
      client,
      params as Parameters<typeof handleDeleteRecord>[1]
    ),

• packages/core/src/tools/definitions.ts:423-423 (registration)

  Export and registration of deleteRecordDefinition in coreToolDefinitions object.

  'delete-record': deleteRecordDefinition,