SendGrid MCP Server

Instructions

Implementation Reference

• src/tools/index.ts:403-406 (handler)

  Handler logic for the 'create_contact_list' tool within the handleToolCall switch statement. It invokes SendGridService.createList with the input 'name' argument and returns a formatted success response including the new list ID.

  case 'create_contact_list':
    const list = await service.createList(args.name);
    return { content: [{ type: 'text', text: `Contact list "${args.name}" created with ID: ${list.id}` }] };

• src/tools/index.ts:95-108 (schema)

  Tool definition including name, description, and input schema requiring a 'name' string parameter.

  {
    name: 'create_contact_list',
    description: 'Create a new contact list in SendGrid',
    inputSchema: {
      type: 'object',
      properties: {
        name: {
          type: 'string',
          description: 'Name of the contact list'
        }
      },
      required: ['name']
    }
  },

• src/services/sendgrid.ts:109-116 (helper)

  SendGridService method that performs the actual API call to create a new contact list using SendGrid's Marketing Lists endpoint.

  async createList(name: string): Promise<SendGridList> {
    const [response] = await this.client.request({
      method: 'POST',
      url: '/v3/marketing/lists',
      body: { name }
    });
    return response.body as SendGridList;
  }