Skip to content
MENU
THE TRUST LAYER FOR AI WORK

Add Zambo.
Get to work.

One hosted connection. No API key. No account. Add it to the AI you already use, ask for one real job, and open the receipt.

https://zambo.dev/mcp

ADD · ASK · VERIFY

Connect.

One URL. Your AI. Real tools.

01 · ADDChoose an app or copy the URL

The address above works with any compatible AI app.

02 · ASKTry a live BTC price

Ask: “What's the live BTC price?”

03 · VERIFYOpen the receipt

Every successful call returns a public record at zambo.dev/run/….

Start free with 20 calls per tool each day. No API key or signup.

Advanced setup (JSON, direct API, and Day Pass)
INSTALL ZAMBO MCP

Install the Zambo MCP.
Start working.

Zambo is an MCP server that gives your AI hands to run real jobs, not just chat: site audits, prompt-injection scans, startup credit hunts and lead lists, each with a verifiable receipt.

Choose how to start. Connect an AI through MCP, or call the API directly with a reproducible request. Every successful call returns a verifiable receipt.

FIRST CALL · READ ONLY

Try one real answer now.

Ask for the live Bitcoin price. No terminal, installation, account, or credential is needed.

  1. ACTION 1Open the demo

    Use the button below. No account and no install.

  2. ACTION 2Press Run the live call

    The demo does not start by itself. One press runs it.

  3. ACTION 3Open the receipt

    The result shows a public receipt you can check.

That is the first-receipt demo. Connecting Zambo to your own AI is separate: menus vary by app, so each client below shows its own steps.

What is the live Bitcoin price right now?
Run this read-only call The browser playground shows loading, errors, the real result, and its receipt.
Path one · MCP

Connect your AI

Use one hosted MCP connection in your existing client. The client list and setup guides are below. Read the MCP execution receipt guide to understand the record for a tool call.

https://zambo.dev/mcp
Path two · Direct API

Call the API directly

Send the same JSON-RPC shape directly, then follow the returned receipt URL.

curl -fsS -X POST https://zambo.dev/mcp -H 'Content-Type: application/json' --data '{"jsonrpc":"2.0","id":"install-direct","method":"tools/call","params":{"name":"zambo_universal","arguments":{"need":"What is the current price of Bitcoin in USD?"}}}'

Python frameworks: langchain-zambo and crewai-zambo.

JavaScript SDK

Use the Zambo JavaScript SDK

The official JavaScript client for Zambo tool calls, search, and tool discovery.

npm install zambo-ai · View zambo-ai on npm

Quickstart
const { Zambo } = require('zambo-ai');
const z = new Zambo();

const job = await z.universal('audit https://example.com for AI discoverability', 'my-session-1');
console.log(job.text);
console.log('receipt:', job.receiptId);

const r = await z.call('live_price', { coin: 'ETH' });
const found = await z.search('generate QR code');
const tools = await z.listTools();
Package chooser · current registry names

Which package do I want?

Package warning: Do not use npm install zambo as the JavaScript SDK. The current zambo package publishes a command-line executable; for a JavaScript app or agent, use the zambo-ai SDK. They are different integration paths.

PyPI also currently lists openai-agents-zambo. Both OpenAI Agents packages are live, with different documented import/API names; neither PyPI project metadata currently marks one as a deprecated alias or says it supersedes the other. Keep existing installs unchanged.

One hosted connection

Keep one Zambo MCP connection. Use this URL only when your client asks for a connector address.

https://zambo.dev/mcp

Pick your client

Each client leads with its quickest action: a link that opens the app where the app supports one, otherwise a paste step. An animated guide and a connector URL fallback follow.

Claude Code

Install Zambo in Claude Code

Copies a prompt with setup instructions for the hosted connector.

Claude Code
Open Claude Code
Add hosted MCP
Ask Claude to use Zambo

The setup moves from your client to the hosted connector, then to your first request.

Fallback: Tell Claude Code, “Add the Zambo MCP server at https://zambo.dev/mcp.”
Advanced setup and verification
claude mcp add --transport http zambo https://zambo.dev/mcp
curl -fsS -X POST https://zambo.dev/mcp -H 'Content-Type: application/json' --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | grep -q '"tools"'
Add your Day Pass key (X-Zambo-Key)

Claude Code supports HTTP headers for remote MCP servers. Replace the placeholder locally; never commit a real key or paste it into this page. Official Claude Code MCP docs.

claude mcp add --transport http zambo https://zambo.dev/mcp --header "X-Zambo-Key: YOUR_DAY_PASS_KEY"

If your installed version does not accept this header option, use the direct API request in the Generic MCP guide.

Google Gemini CLI

Install Zambo in Gemini CLI

Downloads a ready-to-use settings file.

Gemini CLI
Open Gemini CLI
Load MCP settings
Ask Gemini to list tools

The settings file is prepared for Gemini CLI, then you can ask Gemini to confirm the connection.

Fallback: In Gemini CLI MCP settings, use https://zambo.dev/mcp as the hosted server URL.
Add your Day Pass key (X-Zambo-Key)

Gemini CLI documents custom HTTP headers on HTTP MCP server entries. Replace the placeholder only in your private local settings; never commit a real key. Official Gemini CLI MCP docs.

{"mcpServers":{"zambo":{"httpUrl":"https://zambo.dev/mcp","headers":{"X-Zambo-Key":"YOUR_DAY_PASS_KEY"}}}}
Advanced setup and verification

Settings location: ~/.gemini/settings.json.

{"mcpServers":{"zambo":{"httpUrl":"https://zambo.dev/mcp"}}}
curl -fsS -X POST https://zambo.dev/mcp -H 'Content-Type: application/json' --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | grep -q '"tools"'
Cursor

Install Zambo in Cursor

Install in Cursor

Opens Cursor's MCP installer.

Cursor Settings
Open the installer
Add Zambo
Ask Cursor to use it

Cursor opens the installer, adds the hosted server, and returns you to your workspace.

Fallback: In Cursor MCP settings, use https://zambo.dev/mcp as the hosted server URL.
Add your Day Pass key (X-Zambo-Key)

Cursor's MCP configuration supports HTTP headers. Replace the placeholder in your private settings; do not commit a real key. Official Cursor MCP docs.

{"mcpServers":{"zambo":{"url":"https://zambo.dev/mcp","headers":{"X-Zambo-Key":"YOUR_DAY_PASS_KEY"}}}}
Advanced setup and verification

Settings location: .cursor/mcp.json.

{"mcpServers":{"zambo":{"url":"https://zambo.dev/mcp"}}}
curl -fsS -X POST https://zambo.dev/mcp -H 'Content-Type: application/json' --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | grep -q '"tools"'
VS Code

Install Zambo in VS Code

Install in VS Code

Opens VS Code's MCP installer.

VS Code Chat
Open the installer
Add hosted MCP
Ask Chat to use Zambo

VS Code opens its MCP installer, adds the hosted server, and makes it available in Chat.

Fallback: In VS Code MCP settings, use https://zambo.dev/mcp as the hosted server URL.
Add your Day Pass key (X-Zambo-Key)

VS Code's remote MCP config supports a headers object. Replace the placeholder only in private settings and do not commit a real key. Official VS Code MCP configuration reference.

{"servers":{"zambo":{"type":"http","url":"https://zambo.dev/mcp","headers":{"X-Zambo-Key":"YOUR_DAY_PASS_KEY"}}}}
Advanced setup and verification

Settings location: .vscode/mcp.json.

{"servers":{"zambo":{"type":"http","url":"https://zambo.dev/mcp"}}}
curl -fsS -X POST https://zambo.dev/mcp -H 'Content-Type: application/json' --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | grep -q '"tools"'
Windsurf

Install Zambo in Windsurf

Copies the connector URL and opens the setup guide.

Windsurf Cascade
Open Cascade settings
Add hosted MCP
Ask Cascade to use Zambo

The connector URL is ready for Cascade, then your AI can confirm the available tools.

Fallback: In Windsurf MCP settings, use https://zambo.dev/mcp as the hosted server URL.
Add your Day Pass key (X-Zambo-Key)

The official Windsurf page documents a headers field for the legacy Cascade remote HTTP config; that page does not describe the newer Devin Local agent. Replace the placeholder in private config only; never commit a real key. Official Windsurf MCP docs.

{"mcpServers":{"zambo":{"serverUrl":"https://zambo.dev/mcp","headers":{"X-Zambo-Key":"YOUR_DAY_PASS_KEY"}}}}
Advanced setup and verification

Settings location: ~/.codeium/windsurf/mcp_config.json.

{"mcpServers":{"zambo":{"serverUrl":"https://zambo.dev/mcp"}}}
curl -fsS -X POST https://zambo.dev/mcp -H 'Content-Type: application/json' --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | grep -q '"tools"'
Generic MCP client

Install Zambo in any MCP client

Copies the hosted connector URL for your client.

Your MCP client
Open connector settings
Add the hosted URL
Ask your AI to use Zambo

Open your client's connector settings, add the hosted URL, and ask your AI to confirm the connection.

Fallback: Use https://zambo.dev/mcp as the remote MCP server URL.
Send a Day Pass key (X-Zambo-Key)

MCP itself does not guarantee that every client can add custom HTTP headers. If yours supports header configuration, add X-Zambo-Key with your key in its private local settings; never commit it. Otherwise, use this direct API request. It prompts for the key without putting it in shell history, then clears the temporary environment value.

read -rsp 'Day Pass key: ' ZAMBO_DAY_PASS_KEY; echo
  curl -i -X POST https://zambo.dev/mcp \
  -H 'Content-Type: application/json' \
  -H "X-Zambo-Key: ${ZAMBO_DAY_PASS_KEY}" \
  --data '{"jsonrpc":"2.0","id":"key-test","method":"tools/call","params":{"name":"zambo_universal","arguments":{"need":"What is the current price of Bitcoin in USD?"}}}'
unset ZAMBO_DAY_PASS_KEY

Inspect the response for the result and a verifiable receipt URL.

Advanced setup and verification
{"mcpServers":{"zambo":{"url":"https://zambo.dev/mcp"}}}
curl -fsS -X POST https://zambo.dev/mcp -H 'Content-Type: application/json' --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | grep -q '"tools"'
Claude Desktop

Connect Zambo from Claude Desktop

Choose either setup path. The native remote connector is the simplest free path: add https://zambo.dev/mcp in your Claude account under Settings → Connectors (or ask your organization owner to add it). Anthropic's current flow does not document a user-supplied arbitrary X-Zambo-Key header, so it does not carry a Day Pass key.

For a paid Day Pass key, use the local stdio bridge below. Official Claude remote connector guide · Official Claude Desktop local MCP guide · Third-party mcp-remote custom-header docs.

Day Pass setup: create a private header file

The bridge reads one header per line from a local file. Use an absolute file path in Claude's config; protect the file so only your account can read it. Do not put the key in the config JSON, command arguments, shell history, or this webpage.

macOS/Linux example: this prompts without echoing the key or adding it to shell history, creates a private directory/file, then clears the temporary shell variable:

mkdir -p "$HOME/.config/zambo" && chmod 700 "$HOME/.config/zambo"
umask 077
read -rsp 'Day Pass key: ' ZAMBO_DAY_PASS_KEY; echo
printf 'X-Zambo-Key: %s\n' "$ZAMBO_DAY_PASS_KEY" > "$HOME/.config/zambo/headers.txt"
chmod 600 "$HOME/.config/zambo/headers.txt"
unset ZAMBO_DAY_PASS_KEY

The file content is exactly one header line:

X-Zambo-Key: YOUR_DAY_PASS_KEY

On Windows, create the same one-line file at a private absolute path, restrict its file permissions to your Windows account, and use a path without spaces in the config (the mcp-remote docs note an argument-parsing issue for Claude Desktop on Windows).

Copy working claude_desktop_config.json

This local MCP entry invokes the third-party mcp-remote bridge through npx. Replace only the header-file path with its absolute path on your computer. The bridge keeps the secret out of process arguments and fails closed if that file cannot be read. Install/trust the third-party package before enabling this config.

{
  "mcpServers": {
    "zambo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://zambo.dev/mcp",
        "--header-file",
        "/absolute/path/to/headers.txt"
      ]
    }
  }
}

Direct API fallback

If the local bridge cannot be used, this sends a direct call with the key prompted at runtime and then clears the temporary shell value.

read -rsp 'Day Pass key: ' ZAMBO_DAY_PASS_KEY; echo
  curl -i -X POST https://zambo.dev/mcp \
  -H 'Content-Type: application/json' \
  -H "X-Zambo-Key: ${ZAMBO_DAY_PASS_KEY}" \
  --data '{"jsonrpc":"2.0","id":"claude-desktop-key-test","method":"tools/call","params":{"name":"zambo_universal","arguments":{"need":"What is the current price of Bitcoin in USD?"}}}'
unset ZAMBO_DAY_PASS_KEY

Look for the tool result and its verifiable /run/ receipt URL.

ChatGPT

Connect ChatGPT or call the API directly

Easiest path: open the Zambo GPT. No terminal needed.

For technical users: the direct curl request is further down.

ChatGPT's developer-mode MCP app can connect to a remote server at https://zambo.dev/mcp. OpenAI documents No Authentication, OAuth, and Mixed Authentication for these apps, but not a custom arbitrary request-header field for a user-provided X-Zambo-Key. The no-key/free path may work through a supported connector; a Day Pass key cannot be reliably injected there.

For a Day Pass key: Use the direct API request below, or another MCP client whose current docs explicitly support custom HTTP headers. ChatGPT's custom connector URL alone does not send X-Zambo-Key.

Official ChatGPT developer-mode MCP guide

Direct API / curl fallback with X-Zambo-Key

This prompts for the key without placing it in shell history, then removes it from the shell environment. The key is not saved by this page.

read -rsp 'Day Pass key: ' ZAMBO_DAY_PASS_KEY; echo
  curl -i -X POST https://zambo.dev/mcp \
  -H 'Content-Type: application/json' \
  -H "X-Zambo-Key: ${ZAMBO_DAY_PASS_KEY}" \
  --data '{"jsonrpc":"2.0","id":"chatgpt-key-test","method":"tools/call","params":{"name":"zambo_universal","arguments":{"need":"What is the current price of Bitcoin in USD?"}}}'
unset ZAMBO_DAY_PASS_KEY

Look for the tool result and its verifiable /run/ receipt URL.

Python framework integrations

Use these packages to publish verifiable AI agent receipts to zambo.dev from your framework callbacks.

  • langchain-zambo pip install langchain-zambo: LangChain callbacks that publish verifiable AI agent receipts to zambo.dev.
  • crewai-zambo pip install crewai-zambo: CrewAI listeners that publish verifiable AI agent receipts to zambo.dev.

Continue the work across AI clients

Start a job in one AI client, continue it in another, and verify the same session with a verifiable receipt.

Source code GitLab, main code home Codeberg mirror SourceForge mirror
Listed and verified 98/100 on Smithery Official listing on Glama Active on MCPServers.org See all trust sources
Add Zambo