Metadata-Version: 2.4
Name: bevr-mcp
Version: 0.1.0
Summary: Stdio MCP server for building and editing Bevr funnel content (quiz / onboarding / upsell / unsubscribe) via the funnel backend MCP API.
Project-URL: Homepage, https://github.com/job-escape/funnel_backend
Project-URL: Repository, https://github.com/job-escape/funnel_backend
Author-email: JobEscape <margulan@jobescape.me>
License: MIT
Keywords: bevr,funnel,mcp,model-context-protocol
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.2.0
Description-Content-Type: text/markdown

# bevr-mcp

Stdio MCP server for building and editing Bevr funnel content — quizzes, onboarding, upsell, and unsubscribe flows (pages, nodes, dialogues, conditions/splitters, and shared components) — through the funnel backend's MCP API.

It is a thin proxy: it fetches the tool list from your backend and forwards every tool call over HTTPS, authenticating with a per-user API key. No data lives in the client.

## Install / configure

Add to your MCP client config (e.g. Claude Desktop / Claude Code):

```json
{
  "mcpServers": {
    "bevr": {
      "command": "uvx",
      "args": ["bevr-mcp"],
      "env": {
        "BEVR_MCP_BASE_URL": "https://your-funnel-backend.example.com",
        "BEVR_MCP_TOKEN": "fmk_your_key_here"
      }
    }
  }
}
```

| Env var | Meaning |
|---|---|
| `BEVR_MCP_BASE_URL` | Base URL of the funnel backend (no trailing `/mcp`). |
| `BEVR_MCP_TOKEN` | Your personal MCP key (starts with `fmk_`). Generate it on the funnel frontend's **MCP keys** settings page; it is shown once. |

All actions taken through the MCP are attributed to your user and audit-logged on the backend.
