DarkFunnels documentation

ai.darkfunnelsPublished by darkfunnels.aiOfficial publisherv1.0.0Updated Oct 25, 2026

Search and read the DarkFunnels docs: WhatsApp AI sales agents connected by QR, no Meta Cloud API.

VerifiedStreamable HTTPWeb executableFiles & StorageKnowledge & Memory

Overview

AI-generated overview

Hosted, no-auth MCP server for searching and browsing the DarkFunnels documentation, with a tool to report documentation problems.

What you can do
Search the DarkFunnels knowledge base for guides, API references and code examples, with results including page content and links to the source pages in the docs site's virtual filesystem, which can be queried with read-only shell-like commands against a sandboxed in-memory filesystem containing only documentation pages. Submit feedback to the docs team when a page is incorrect, outdated, confusing, incomplete or has a broken example.
When to use it
Use it when you need to answer questions about DarkFunnels, find specific documentation, understand how a feature works, or locate implementation details, and when you want to report a problem with a documentation page.
Requirements
A remote Streamable HTTP endpoint at no authentication, account, API key or local runtime is needed.
Before you install
The filesystem tool is a read-only sandbox over documentation pages only, not a shell on any real machine. The feedback tool sends your report to the docs team, so avoid including sensitive information. The server is closed source and hosted by a third party.

Installation

In SourceWeft

  1. Open DarkFunnels documentation in the dashboard and add it to a workspace.
  2. 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%2Fdocs/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.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "darkfunnels-documentation": {
      "type": "http",
      "url": "https://docs.darkfunnels.ai/mcp"
    }
  }
}

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

Connect

https://mcp.darkfunnels.ai/mcp?features=all
  • Transport: Streamable HTTP, stateless. No SSE; GET/DELETE on /mcp answer 405.
  • 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 answers 401 with a WWW-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=all is the recommended value: it takes the whole catalog, including groups published after you connect. A _write group always brings its matching read group with it.
  • ?read_only=true — disables every write, and takes precedence over everything else, all included.
  • ?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

  1. "Review yesterday's WhatsApp conversations and tell me where we are losing sales."
  2. "Read my sales agent's manual and propose an improvement to the closing chapter; save it once I approve."
  3. "List the customers who have gone 3+ days without a reply and draft what the agent should say to re-engage each one."

Links

Registry

Published to the official MCP registry as ai.darkfunnels/whatsapp-sales-agent. See server.json.

Source: README.md at commit 0ba8c0d

Tools

3

search_dark_funnels

Search documentation

Search across the DarkFunnels knowledge base to find relevant information, code examples, API references, and guides. Use this tool when you need to answer questions about DarkFunnels, find specific documentation, understand how features work, or locate implementation details. The search returns contextual content with titles and direct links to the documentation pages. If you need the full content of a specific page, use the query_docs_filesystem tool to `head` or `cat` the page path (append `.mdx` to the path returned from search — e.g. a result at `/some/page` is read with `head -200 /some/page.mdx`).

Parametersqueryrequiredlanguage

query_docs_filesystem_dark_funnels

Query documentation filesystem

Run a read-only shell-like query against a virtualized, in-memory filesystem rooted at `/` that contains ONLY the DarkFunnels documentation pages. This is NOT a shell on any real machine — nothing runs on the user's computer, the server host, or any network. The filesystem is a sandbox backed by documentation chunks. This is how you read documentation pages: there is no separate "get page" tool. To read a page, pass its `.mdx` path to `head` or `cat` — a page at the URL path `/some/page` lives at `/some/page.mdx`. To search the docs with exact keyword or regex matches, use `rg`. To understand the docs structure, use `tree` or `ls`. **Paths are specific to this site — never guess them.** Discover real paths with `tree / -L 2`, `ls /`, or the search tool before reading. If a path does not exist, that only means the guess was wrong; it does NOT mean the topic is undocumented — use `rg -il "keyword" /` to find where it is covered. **Workflow:** Start with the search tool for broad or conceptual queries like "how to authenticate" or "rate limiting". Use this tool when you need exact keyword/regex matching, structural exploration, or to read the full content of a specific page by path. Supported commands: rg (ripgrep), grep, find, tree, ls, cat, head, tail, stat, wc, sort, uniq, cut, sed, awk, jq, plus basic text utilities. No writes, no network, no process control. Run `--help` on any command for usage. Each call is STATELESS: the working directory always resets to `/` and no shell variables, aliases, or history carry over between calls. If you need to operate in a subdirectory, chain commands in one call with `&&` or pass absolute paths (e.g., `cd /some-directory && ls` or `ls /some-directory`). Do NOT assume that `cd` in one call affects the next call. Examples (replace the placeholder paths with real ones from `tree` or search): - `tree / -L 2` — see the top-level directory layout - `rg -il "rate limit" /` — find all files mentioning "rate limit" - `rg -C 3 "api

Parameterscommandrequired

submit_feedback

Submit documentation feedback

Report a problem with this documentation site so the docs team can fix it. Use when a documentation page is incorrect, outdated, confusing, incomplete, or has a broken example. This is for feedback about the documentation content itself — not for product support requests or feedback about this tool or assistant.

Parameterspathrequiredfeedbackrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

90% 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 listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Darkfunnels integrations

DarkFunnels

ai.darkfunnelsOfficial publisher

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…

Streamable HTTPWeb executableAuth
Communication & CollaborationCredential requiredOct 24, 2026