Evolution API WhatsApp MCP Server

Instructions

Implementation Reference

• src/index.ts:608-618 (handler)

  MCP tool handler for 'instance_status' that fetches the instance connection status from EvolutionAPI and returns it as JSON text content.

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

• src/index.ts:492-493 (registration)

  Switch case that registers and dispatches calls to the 'instance_status' tool handler.

  case 'instance_status':
    return await this.handleInstanceStatus(args);

• src/index.ts:76-85 (schema)

  Registration in tools list with input schema requiring 'instanceName' string.

    name: 'instance_status',
    description: 'Get connection status of an instance',
    inputSchema: {
      type: 'object',
      properties: {
        instanceName: { type: 'string', description: 'Instance name' }
      },
      required: ['instanceName']
    }
  },

• src/services/evolution-api.ts:64-70 (helper)

  Core helper function that makes HTTP GET request to Evolution API endpoint /instance/connectionState/{instanceName} to retrieve status.

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