vibe-prospecting

Power your chat with B2B data to create lead lists, research companies, personalize your outreach, and more.

Open source Open in the app JSON README (API)

About

Power your chat with B2B data to create lead lists, research companies, personalize your outreach, and more.

Details

Kind: Plugins
Topic: No topic detected
Publisher: explorium-ai
Origin: gemini
Category: ferramentas
Version: 2.0.0
Stars: 32
Forks: 8
Open pull requests: 1
Last push: 2026-07-19T10:41:39Z
Repository state: ativo
Language: JavaScript
License: MIT
Added: 2026-08-30 14:13:39
Updated: 2026-08-30 14:13:39
Origin id: explorium-ai/vibeprospecting-mcp

README

# Vibe Prospecting

**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:** <https://www.vibeprospecting.ai/pricing>

---

## 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.

## License

This project is licensed under the Explorium Term of Service. See [Term of Service](https://www.vibeprospecting.ai/terms-of-service) for details.

vibe-prospecting

About

Details

README

More