SendGrid MCP Server

Instructions

Implementation Reference

• src/tools/index.ts:524-537 (handler)

  Handler for the 'get_single_send' tool call. It invokes the SendGrid service to retrieve the single send by ID and returns a formatted JSON response with key details.

  case 'get_single_send':
    const retrievedSingleSend = await service.getSingleSend(args.single_send_id);
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({
          id: retrievedSingleSend.id,
          name: retrievedSingleSend.name,
          status: retrievedSingleSend.status,
          send_at: retrievedSingleSend.send_at,
          list_ids: retrievedSingleSend.send_to.list_ids
        }, null, 2)
      }]
    };

• src/services/sendgrid.ts:286-292 (helper)

  Core service method that performs the actual API request to SendGrid to fetch details of a specific single send.

  async getSingleSend(singleSendId: string): Promise<SendGridSingleSend> {
    const [response] = await this.client.request({
      method: 'GET',
      url: `/v3/marketing/singlesends/${singleSendId}`
    });
    return response.body as SendGridSingleSend;
  }

• src/tools/index.ts:333-342 (schema)

  Input schema definition for the 'get_single_send' tool, specifying the required 'single_send_id' parameter.

  inputSchema: {
    type: 'object',
    properties: {
      single_send_id: {
        type: 'string',
        description: 'ID of the single send to retrieve'
      }
    },
    required: ['single_send_id']
  }

• src/tools/index.ts:330-343 (registration)

  Registration of the 'get_single_send' tool within the getToolDefinitions array, including name, description, and input schema.

  {
    name: 'get_single_send',
    description: 'Get details of a specific single send',
    inputSchema: {
      type: 'object',
      properties: {
        single_send_id: {
          type: 'string',
          description: 'ID of the single send to retrieve'
        }
      },
      required: ['single_send_id']
    }
  },