home / mcp / whatsapp osint mcp server

Whatsapp Osint MCP Server

Provides access to Whatsapp Osint API endpoints and OSINT insights via MCP with authentication.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bach-ai-tools-bachai-whatsapp-osint": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

The Whatsapp Osint MCP Server provides a standardized way to access the Whatsapp Osint API through the MCP platform. It enables you to run locally or via an MCP client, manage authentication, and invoke a set of endpoints to retrieve WhatsApp data and OSINT insights.

How to use

You will connect to this MCP server through an MCP client (such as a local uploader or a cloud MCP management tool). Treat this server as a backend you point your MCP client at, supplying your API key for authentication. You can run it in multiple ways and switch between them without changing your application code.

How to install

Prerequisites you need before installation:

- Python 3.x (for pip installation and local development) or any environment capable of running the provided commands.

- pip (Python package manager) for installing the package.

Install and run using different methods

pip install bach-whatsapp_osint
```

```bash
pip install -e .
```

```bash
uvx --from bach-whatsapp_osint bach_whatsapp_osint
```

```bash
uvx --from bach-whatsapp_osint@latest bach_whatsapp_osint
```

```bash
python server.py
```

```bash
pip install bach-whatsapp_osint

bach_whatsapp_osint
`

Environment and startup details

The server requires an API key for authentication. You must provide the key as an environment variable when starting the server. The key is used to authorize requests to the Whatsapp Osint API.

Configuration

{
  "mcpServers": {
    "bach-whatsapp_osint": [
      {
        "type": "stdio",
        "name": "bach_whatsapp_osint_uvx_latest",
        "command": "uvx",
        "args": ["--from", "bach-whatsapp_osint@latest", "bach_whatsapp_osint"],
        "env": {
          "API_KEY": "your_api_key_here"
        }
      },
      {
        "type": "stdio",
        "name": "bach_whatsapp_osint_uvx",
        "command": "uvx",
        "args": ["--from", "bach-whatsapp_osint", "bach_whatsapp_osint"],
        "env": {
          "API_KEY": "your_api_key_here"
        }
      },
      {
        "type": "stdio",
        "name": "bach_whatsapp_osint_python",
        "command": "python",
        "args": ["server.py"],
        "env": {
          "API_KEY": "your_api_key_here"
        }
      },
      {
        "type": "stdio",
        "name": "bach_whatsapp_osint_cli",
        "command": "bach_whatsapp_osint",
        "args": [],
        "env": {
          "API_KEY": "your_api_key_here"
        }
      }
    ]
  }
}

Security and usage notes

Keep your API key secure. Do not expose it in client-side code or public repositories. Use environment variables to inject the API key at runtime and prefer dedicated MCP profiles for different applications.

Examples and endpoints

This server provides endpoints such as: - POST /bizos to get business insights for WhatsApp numbers - GET /about for a user’s status - GET /devices to learn how many devices are linked - GET /privacy to fetch privacy settings - GET /wspic/b64 to fetch a base64-encoded profile picture - GET /wspic/dck to check if a number is on WhatsApp and see profile visibility - GET /wspic/dck for public image URL when available.

Tools and endpoints overview

business_insights  -> POST /bizos
status             -> GET /about
devices            -> GET /devices
privacy_settings   -> GET /privacy
base64_encoded_profile -> GET /wspic/b64
fetch_osint_info   -> GET /wspic/dck

Available tools

business_insights

Returns business status and verified name for an array of WhatsApp numbers.

status

Whatsapp user's status info.

devices

Returns the number of linked devices (up to 4) for a given WhatsApp number.

privacy_settings

Fetch user privacy settings for a given phone number.

base64_encoded_profile

Fetch the base64 encoded image of a WhatsApp number's profile picture.

fetch_osint_info

Determine if a number is registered on WhatsApp and provide profile visibility information.