{
  "markdown": "# Proofpoint Essentials MCP Server\n\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg)](https://nodejs.org/)\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for the\n[Proofpoint Essentials](https://us1.proofpointessentials.com/api/v1/docs/index.php) API.\nEnables AI assistants to manage MSP-multi-tenant email security: organizations, domains,\nusers, licensing, features, subscription packages, and email flow reporting.\n\nThis is a distinct product/API from Proofpoint TAP (see\n[`proofpoint-mcp`](https://github.com/WYRE-AI/proofpoint-mcp) for TAP threat intelligence,\nquarantine, and URL defense) — Essentials is Proofpoint's SMB/MSP email-security product,\nwith its own base URL, auth model, and org-management surface.\n\n> **Part of the [WYRE AI](https://github.com/WYRE-AI) MCP fleet** — a growing suite of AI\n> integrations for the MSP stack.\n\n## Installation\n\n```bash\nnpm install @wyre-ai/proofpoint-essentials-mcp\n```\n\n## Configuration\n\nSet the following environment variables:\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `PROOFPOINT_ESSENTIALS_USERNAME` | Yes | Org-administrator username (sent as the `X-User` header) |\n| `PROOFPOINT_ESSENTIALS_PASSWORD` | Yes | Org-administrator password (sent as the `X-Password` header) |\n| `PROOFPOINT_ESSENTIALS_REGION` | No | Region subdomain, e.g. `us1` or `eu1` (default: `us1`) |\n| `MCP_TRANSPORT` | No | Transport mode: `stdio` (default) or `http` |\n\nOnly organization-administrator accounts can authenticate against this API; end-user\naccounts cannot.\n\n## Usage\n\n### Running with Claude Desktop\n\nAdd to your Claude Desktop `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"proofpoint-essentials-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"@wyre-ai/proofpoint-essentials-mcp\"],\n      \"env\": {\n        \"PROOFPOINT_ESSENTIALS_USERNAME\": \"your-username\",\n        \"PROOFPOINT_ESSENTIALS_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n### Running with Claude Code (CLI)\n\n```bash\nclaude mcp add proofpoint-essentials-mcp \\\n  -e PROOFPOINT_ESSENTIALS_USERNAME=your-value \\\n  -e PROOFPOINT_ESSENTIALS_PASSWORD=your-value \\\n  -- npx -y @wyre-ai/proofpoint-essentials-mcp\n```\n\n### Docker\n\n```bash\ndocker build --platform linux/amd64 --build-arg GITHUB_TOKEN=$(gh auth token) -t proofpoint-essentials-mcp .\ndocker run \\\n  -e PROOFPOINT_ESSENTIALS_USERNAME=your-value \\\n  -e PROOFPOINT_ESSENTIALS_PASSWORD=your-value \\\n  -e MCP_TRANSPORT=http \\\n  -p 8080:8080 proofpoint-essentials-mcp\n```\n\n## Available Tools\n\nProofpoint Essentials is an MSP multi-tenant API — every org/domain/user-scoped tool\ntakes the target customer organization's domain as a per-call argument (credentials are\nnot scoped to a single org).\n\n### Organizations\n- `proofpoint_essentials_org_get` — get org data and its domains\n- `proofpoint_essentials_org_set_active` — activate/deactivate an org ⚠ high-impact\n- `proofpoint_essentials_org_delete` — delete an org ⚠ destructive, irreversible\n\n### Domains\n- `proofpoint_essentials_domains_list`\n- `proofpoint_essentials_domains_create` — batch add\n- `proofpoint_essentials_domains_update` ⚠ high-impact\n- `proofpoint_essentials_domains_delete` ⚠ destructive, irreversible\n\n### Users\n- `proofpoint_essentials_users_list`\n- `proofpoint_essentials_users_get`\n- `proofpoint_essentials_users_create` — batch add\n- `proofpoint_essentials_users_update` ⚠ high-impact\n- `proofpoint_essentials_users_delete` ⚠ destructive, irreversible\n\n### Endpoint discovery\n- `proofpoint_essentials_endpoint_discover` — resolve which region hosts a customer domain\n\n### Features / Licensing / Package\n- `proofpoint_essentials_features_get` / `proofpoint_essentials_features_update` ⚠ high-impact\n- `proofpoint_essentials_licensing_get` / `proofpoint_essentials_licensing_update` ⚠ high-impact\n- `proofpoint_essentials_package_update` ⚠ high-impact\n\n### Reporting\n- `proofpoint_essentials_reporting_get` — inbound/outbound email flow metrics\n\n### Token\n- `proofpoint_essentials_token_create` — mint an Odin-based SSO token\n\nDestructive tools require explicit confirmation. Interactive MCP clients are prompted\nvia elicitation; non-interactive callers (e.g. the WYRE gateway) must pass\n`confirm_destructive_action: true` and are otherwise blocked.\n\n## Development\n\n```bash\ngit clone https://github.com/WYRE-AI/proofpoint-essentials-mcp.git\ncd proofpoint-essentials-mcp\nnpm install\nnpm run build\nnpm test\nnpm run smoke   # requires a prior `npm run build`\n```\n\n## Contributing\n\nContributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md), or open an\nissue to discuss changes.\n\n## License\n\nLicensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.\n",
  "bytes": 4843,
  "sha": "53db3027817c2ed35af41f41b214b802c159008ec3432c76db1003b1a45b2ab6",
  "repo_slug": "wyre-ai/proofpoint-essentials-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_wyre_ai_proofpoint_essentials__b811e61c/readme"
}