Evolution API WhatsApp MCP Server

Instructions

Implementation Reference

• src/index.ts:596-606 (handler)

  The main MCP tool handler function for 'connect_instance'. It extracts the instanceName from args, calls evolutionAPI.connectInstance, and returns the result as a formatted JSON text response.

  private async handleConnectInstance(args: any) {
    const result = await evolutionAPI.connectInstance(args.instanceName);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2)
        }
      ]
    };
  }

• src/index.ts:67-73 (schema)

  Input schema definition for the 'connect_instance' tool, specifying instanceName as required string.

  inputSchema: {
    type: 'object',
    properties: {
      instanceName: { type: 'string', description: 'Instance name to connect' }
    },
    required: ['instanceName']
  }

• src/index.ts:64-74 (registration)

  Tool registration in the tools array, including name, description, and input schema. Used by the MCP listTools handler.

  {
    name: 'connect_instance',
    description: 'Connect a WhatsApp instance',
    inputSchema: {
      type: 'object',
      properties: {
        instanceName: { type: 'string', description: 'Instance name to connect' }
      },
      required: ['instanceName']
    }
  },

• src/index.ts:490-491 (registration)

  Dispatcher switch case that routes 'connect_instance' tool calls to the handleConnectInstance method.

  case 'connect_instance':
    return await this.handleConnectInstance(args);

• src/services/evolution-api.ts:44-47 (helper)

  Helper method in EvolutionAPI service that makes the HTTP GET request to connect the WhatsApp instance via the Evolution API backend.

  async connectInstance(instanceName: string): Promise<Instance> {
    const response = await this.client.get(`/instance/connect/${instanceName}`);
    return response.data;
  }