# Vibe Prospecting Vibe Prospecting Logo **Power your chat with live B2B data β€” build lead lists, research companies, enrich contacts, and personalize outreach, all from inside your AI assistant.** Vibe Prospecting is a **remote MCP server**. There's nothing to run locally and no API key to manage β€” you connect over a single URL and sign in through your browser on first use. > **MCP endpoint:** `https://vibeprospecting.explorium.ai/mcp` --- ## What you can do - πŸ”Ž **Find companies** by name, domain, industry, size, location, tech stack, and more - πŸ‘€ **Discover & enrich contacts** β€” roles, profiles, and buying signals at any company - 🏒 **Research firms** β€” firmographics, technographics, funding, competitors, and challenges - πŸ“ˆ **Analyze & export** β€” preview a sample instantly, then export the full dataset to CSV when you're ready You always see a **sample preview first** (5–10 rows). The full dataset is only processed when you explicitly ask to export β€” so exploring is fast and credit-friendly. --- ## Installation Pick your tool below. All clients connect to the same remote endpoint and authenticate through your browser (OAuth) on first use. ### Claude Code ⭐ recommended One line β€” paste it into your terminal: ```bash claude mcp add --transport http vibe-prospecting https://vibeprospecting.explorium.ai/mcp ``` Then start (or restart) Claude Code and run a prompt that uses it (see [Examples](#examples)). The first call opens your browser to sign in. Verify the connection anytime with: ```bash claude mcp list # vibe-prospecting: https://vibeprospecting.explorium.ai/mcp - βœ“ Connected ``` ### Cowork & Claude Desktop Add it as a custom connector through the UI (no terminal needed): 1. Open **Customize β†’ Connectors** in Chat/Cowork/Code in Claude Desktop 2. Click the **+** next to *Connectors* and choose **Browse connectors** 3. Under `Anthropic & Partners` look for **Name:** `Vibe Prospecting` β€” **URL:** `https://vibeprospecting.explorium.ai/mcp` 4. Click **+** and then click **Install**, then follow the sign-in prompts to grant access Once added, Vibe Prospecting's tools are available to Claude automatically. ### Codex CLI One command β€” Codex detects OAuth automatically and opens your browser to sign in: ```bash codex mcp add vibe-prospecting --url https://vibeprospecting.explorium.ai/mcp ``` Confirm it's connected with `codex mcp list` (look for `Auth: OAuth`), or start a Codex session and run `/mcp` to see its tools. If you ever need to re-authenticate, run `codex mcp login vibe-prospecting`. > **No native OAuth in your Codex version?** Use the universal `mcp-remote` bridge instead. Add this block to `~/.codex/config.toml` β€” it opens the browser for sign-in on first use: > > ```toml > [mcp_servers.vibe-prospecting] > command = "npx" > args = ["-y", "mcp-remote", "https://vibeprospecting.explorium.ai/mcp"] > ``` ### Gemini CLI Install the extension directly from this repository: ```bash gemini extensions install https://github.com/explorium-ai/vibeprospecting-mcp ``` The extension is loaded and managed automatically by Gemini CLI, and OAuth sign-in is handled on first use. See the [Gemini CLI extensions docs](https://geminicli.com/docs/extensions/) for details. ### Manus Connect Vibe Prospecting from Manus’s built-in connectors UI (no local server or API key): 1. Open the **connectors** menu (or choose **+ Add connectors**). 2. Search for **`vibe`**. 3. Under **Apps**, select **Vibe Prospecting** (β€œBuild B2B lead lists and enrich companies and contacts”). 4. Confirm the connector details (MCP by Explorium), then click **Try it out** / connect and complete the browser sign-in. Once connected, use Vibe Prospecting from a Manus chat with prompts like those in [Examples](#examples). ### Hermes Hermes uses the same remote endpoint, but its CLI needs the server written to config plus an explicit OAuth login. Run these in your terminal: 1. **Register the server** β€” write **both** keys directly under `mcp_servers:`, which is the namespace `hermes mcp login` (and the runtime) read from: ```bash hermes config set mcp_servers.vibe_prospecting.url "https://vibeprospecting.explorium.ai/mcp" hermes config set mcp_servers.vibe_prospecting.auth oauth ``` Don't use `hermes mcp add`: in a non-interactive shell it can fail mid-way and save a **disabled, half-written entry** under `mcp_servers:` β€” `auth` set but `url` dropped β€” which then fails at login. Setting both keys yourself avoids it, and if you already hit it, the same two commands repair it. (A `url` showing up elsewhere in config doesn't count β€” `hermes mcp login` only reads `mcp_servers:`.) 2. **Sign in** β€” opens your browser to authenticate: ```bash hermes mcp login vibe_prospecting ``` On a **remote, SSH, or Docker** host, the browser can't reach the local callback after you approve β€” that's expected. Copy the **full URL** from the address bar and paste it back at the Hermes prompt. 3. **Verify & use** β€” `hermes mcp list` should show `vibe_prospecting` as authenticated. Start a new chat so the `mcp_vibe_prospecting_*` tools load, then try a prompt from [Examples](#examples). To get a CSV, ask Hermes to **"export and download"** (exports return a link, not the file itself). > **Connection drops on the first call?** The default MCP discovery timeout is too short for the OAuth handshake β€” raise it: `hermes config set mcp_discovery_timeout 10`. --- ## Examples Once connected, just ask in plain language: ``` Who should I contact for a partnership with monday.com? Get anyone who can promote a partnership with them, with all the contact details you can find. ``` ``` What are the business challenges of Amazon? ``` ``` Get the engineering leadership team at Palo Alto Networks. ``` ``` Find B2B SaaS companies in New York with 50–200 employees, then enrich the decision-makers and export the list to CSV. ``` --- ## Authentication & credits - **Sign-in:** OAuth through your browser on first use β€” no API keys to copy or store. - **Free to explore:** searching and previewing samples is lightweight. Exporting the full dataset uses credits. - **Pricing & credits:** --- ## Troubleshooting - **`Failed to connect` / error `-32000` in Claude Code** β€” this happens with the old local `uvx vibeprospecting-mcp` (stdio) command. That path is **deprecated**; use the `--transport http` command above instead. - **Connector won't connect in Cowork/Desktop** β€” the server is reached from Anthropic's cloud, so the URL must be publicly reachable. Double-check the URL is exactly `https://vibeprospecting.explorium.ai/mcp`. - **Re-authenticate** β€” in Claude Code run `claude mcp remove vibe-prospecting` then re-add it; in Codex run `codex mcp login vibe-prospecting` again; in Hermes run `hermes mcp login vibe_prospecting` again. --- ## Support & documentation - [API Documentation](https://docs.vibeprospecting.ai) - [Support & Help Center](https://www.vibeprospecting.ai/contact-us) - [Vibe Prospecting Homepage](https://www.vibeprospecting.ai) For technical support, contact support@vibeprospecting.ai. ## Directory listings Listed in the [Claude Market MCP directory](https://www.claudemarket.ai/mcp). ## License This project is licensed under the Explorium Term of Service. See [Term of Service](https://www.vibeprospecting.ai/terms-of-service) for details.