
DarkFunnels
ai.darkfunnelsPublished by darkfunnels.aiOfficial publisherv1.0.1Updated Oct 24, 2026
WhatsApp AI sales agent on your own number via QR, no Meta API: audit chats, edit playbook, orders.
The publisher's own server: DarkFunnels documentation
Overview
Hosted MCP server that lets an assistant operate a business's WhatsApp AI sales agent: audit chats, edit the sales playbook, and read catalog, orders and…
- What you can do
- Audit real WhatsApp conversations and identify where sales are lost
- Read and edit the versioned sales playbook, with undo, and manage the product catalog
- Read orders, stock and sales metrics
- Assign tags to customers and create sales funnels
- Check which account is connected via a whoami tool
- Scope the connection with URL parameters for feature groups, read-only mode, unmasked phone numbers, or a single funnel
- When to use it
- Useful for owners of a DarkFunnels workspace who want their assistant to review WhatsApp sales conversations, propose and save playbook improvements, or report on orders, stock and metrics without opening the dashboard.
- Requirements
- A remote Streamable HTTP endpoint; no local install. Requires a DarkFunnels account and OAuth 2.1 authorization with dynamic client registration, using the same account as the dashboard. The connection URL accepts query parameters such as features, read_only, pii and agent.
Installation
In SourceWeft
- Open DarkFunnels in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/ai.darkfunnels%2Fwhatsapp-sales-agent/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.
{
"mcpServers": {
"darkfunnels": {
"type": "http",
"url": "https://mcp.darkfunnels.ai/mcp?features=all"
}
}
}README
DarkFunnels — MCP server
A hosted, multi-tenant MCP server that lets your assistant operate a WhatsApp AI sales agent: audit real conversations and find where sales are lost, edit the versioned sales playbook with undo, manage the product catalog, and read orders, stock and metrics — all scoped to your own account.
This repository is the public front door: the server itself is closed source.
Read the documentation first — no account needed
- Public docs MCP server (no auth):
https://docs.darkfunnels.ai/mcp— search every page and browse a read-only virtual filesystem of the documentation. Registry entry:ai.darkfunnels/docs. - Skill file: https://docs.darkfunnels.ai/skill.md —
npx skills add https://docs.darkfunnels.ai. - Plain text: https://docs.darkfunnels.ai/llms.txt and
https://docs.darkfunnels.ai/llms-full.txt; append
.mdto any docs URL.
Connect
- Transport: Streamable HTTP, stateless. No SSE;
GET/DELETEon/mcpanswer405. - Auth: OAuth 2.1 with dynamic client registration. Nothing to request from us and no waiting list — any DarkFunnels account can connect.
- Discovery:
https://mcp.darkfunnels.ai/.well-known/oauth-protected-resource/mcp(RFC 9728). An unauthenticated call answers401with aWWW-Authenticate: Bearer resource_metadata=…header, which is what makes a compliant client start the flow on its own.
Authorize with the same account you use for the dashboard. Authorizing with
a different one connects successfully to that other, probably empty, workspace —
if your assistant says you have no products, check that first. The whoami tool
answers which account is connected.
What it is for
DarkFunnels puts an AI sales agent on a business's WhatsApp. The business connects the number it already uses by scanning a QR code from the dashboard, the same linked-device mechanism as WhatsApp Web: there is no Meta Cloud API application to get approved, no message templates to submit, and no per-conversation fee. DarkFunnels is not a Meta product and is not affiliated with Meta.
This server is how the owner's own assistant — Claude, ChatGPT, Codex or any MCP client — operates that workspace.
Scoping the connection
Four query parameters decide what the assistant can do:
?features=— an explicit list replaces the default set, it does not extend it.?features=allis the recommended value: it takes the whole catalog, including groups published after you connect. A_writegroup always brings its matching read group with it.?read_only=true— disables every write, and takes precedence over everything else,allincluded.?pii=full— unmasks end-customer phone numbers, which are masked by default.?agent=<uuid>— pins the connection to one sales funnel.
Without ?features=, the default set is read-only apart from a single
non-destructive write: assigning tags to customers.
Tools
44 tools across 14 feature groups. Every one declares a title and the
applicable readOnlyHint or destructiveHint, so a client can show the owner
what it is about to do.
Full reference, generated from the source code: https://docs.darkfunnels.ai/en/reference/tools
Tool titles and descriptions are written in Spanish. That is deliberate: it is the exact text the connector sends to the model, refined against real operational failures in a product whose users are Spanish-speaking business owners. Translating it would describe a tool that does not exist.
What it will never do
This connector never moves funds and cannot execute payments. Order and sales data is read-only: nothing in the tool surface initiates, captures, or refunds a payment.
One tool creates a sales funnel, which consumes a subscription seat. It never initiates a payment: when the seat limit is reached the call fails closed, and the owner completes any purchase in the DarkFunnels dashboard.
Try it with these
- "Review yesterday's WhatsApp conversations and tell me where we are losing sales."
- "Read my sales agent's manual and propose an improvement to the closing chapter; save it once I approve."
- "List the customers who have gone 3+ days without a reply and draft what the agent should say to re-engage each one."
Links
- Agent guide: https://darkfunnels.ai/agents
- Documentation (English): https://docs.darkfunnels.ai/en
- Connection URL parameters: https://docs.darkfunnels.ai/en/reference/connection-url
- Security and privacy: https://docs.darkfunnels.ai/en/security
- Privacy policy: https://darkfunnels.ai/privacy
- Skills and Claude Code plugin: https://github.com/darkfunnels-ai/optimind-skills
Registry
Published to the official MCP registry as ai.darkfunnels/whatsapp-sales-agent.
See server.json.
Source: README.md at commit 0ba8c0d
Tools
0Version history
1- v1.0.1LatestSep 16, 2026
Score
75% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Declare a license in the repository or the registry entry.