VOYGR Prospecting MCP server
Commit Nov 12, 2026Find US businesses by city and category to build lead lists with contact details, owners, and custom attribute enrichment.
Also known as voygr-tech/prospecting, prospecting
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.2.3
- Last commit
- Nov 12, 2026
- License
- MIT
What is VOYGR Prospecting MCP?
VOYGR Prospecting finds US businesses by city and category to build lead lists with contact details, owners, and custom attribute enrichment.
Summary generated from the project's README
About VOYGR Prospecting MCP server
Building targeted lead lists of US businesses by city and category is what VOYGR Prospecting enables for sales and research professionals. The server accesses a database of over 16 million US places to find contact details, business owners, legal entities, and operating hours. Users can also perform custom attribute enrichment by describing specific requirements in plain English, such as checking if a specific retailer carries certain products.
This tool works with various MCP clients including Claude Chat, ChatGPT, Claude Code, Codex, and Cursor via streamable HTTP transport. Setup is straightforward through OAuth sign-in in your browser, meaning you do not need to manually manage API keys for most connections. The server utilizes your existing VOYGR account and credit balance to process requests. While counting and previewing matches is free, paid searches, list imports, and field lookups incur charges per place. The system is designed to be cautious, providing credit quotes and asking for confirmation before executing any paid actions.
What you can do with it
- 1Generate local business leadsFind a specific number of independent businesses in a certain city and category to build a contact list.
- 2Perform custom attribute enrichmentAsk the AI to research specific business details that are not part of standard contact information.
- 3Export lead data to CSVConvert the research results found during a chat session into a structured file for external use.
- 4Verify business status and hoursIdentify whether local businesses are currently open or closed and check their operating schedules.
Written from the project's README. Every use case is checked against a quote from it.
How to install VOYGR Prospecting MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall VOYGR Prospecting MCP in Claude Code
$ claude mcp add --transport http prospecting https://api.voygr.tech/places/mcpInstall VOYGR Prospecting MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"prospecting": {
"url": "https://api.voygr.tech/places/mcp"
}
}
}Install VOYGR Prospecting MCP in VS Code
.vscode/mcp.json
{
"servers": {
"prospecting": {
"type": "http",
"url": "https://api.voygr.tech/places/mcp"
}
}
}Install VOYGR Prospecting MCP in VS Code CLI
$ code --add-mcp '{"name":"prospecting","type":"http","url":"https://api.voygr.tech/places/mcp"}'Install VOYGR Prospecting MCP in Codex
$ codex mcp add prospecting --url https://api.voygr.tech/places/mcpInstall VOYGR Prospecting MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.prospecting] url = "https://api.voygr.tech/places/mcp"
Install VOYGR Prospecting MCP in Gemini CLI
$ gemini mcp add -s user --transport http prospecting https://api.voygr.tech/places/mcpInstall VOYGR Prospecting MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"prospecting": {
"url": "https://api.voygr.tech/places/mcp",
"type": "http"
}
}
}Configuration
VOYGR_API_KEY
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablevoygr-tech/prospecting is public and reachablegithub.com/voygr-tech/prospecting ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/voygr-tech/prospecting ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubVOYGR Prospecting
Find US local businesses by city and category and build lead lists with owners, contacts, open/closed status and hours. 16M+ US places.
Enrich your US business lists with owners and key people with email and phone, legal entity, website, and any custom attribute you describe in plain English ("does this jeweler sell lab-grown diamonds").
- 16M+ US places
- Count and five-place preview are free; paid search and search-backed list imports charge per place. Completed field lookups can be charged even when no answer is found; failed lookups are free.
- Results as a table in chat or a CSV export
Install
The Claude Code and Codex plugins include this skill and connect the Prospecting MCP server. Claude Chat, Cowork, ChatGPT, and other MCP clients can connect to the same server. Sign in once in your browser. You do not need to copy an API key for these connections. The server uses your VOYGR account and credit balance.
Claude Code
Run inside Claude Code:
/plugin marketplace add voygr-tech/prospecting
/plugin install prospecting@prospecting
Choose user scope if prompted. Run /mcp, select plugin:prospecting:places, and sign in.
The skill answers to /prospecting:prospecting.
Cowork
Add the custom connector as described in Claude Chat. It is available in Claude Chat, Cowork, and Claude Desktop after you sign in. You do not need a terminal or an API key.
Claude Chat
Add VOYGR Prospecting as a custom connector in claude.ai:
- On a personal plan, open Settings > Connectors > Add custom connector.
On a Team or Enterprise plan, an Owner adds it under Organization settings
Connectors; each member then signs in with their own VOYGR account.
- Name it
VOYGR Prospectingand enterhttps://api.voygr.tech/places/mcpas the URL. Keep the sign-in setting Claude detects. - Select Add, sign in with your VOYGR account, and allow access.
Select VOYGR Prospecting from the tools menu in a chat to use the places_*
tools. Ask Claude to count and preview matches, then check the charge with you
before each paid search or lookup.
ChatGPT
Add VOYGR Prospecting as a custom MCP app in ChatGPT on the web. Custom apps depend on your ChatGPT plan.
- Open Plugins, then + > Create plugin > Create MCP App.
- Name it
VOYGR Prospecting, set the server URL tohttps://api.voygr.tech/places/mcp, and choose OAuth authentication. Leave the OAuth settings ChatGPT discovers as they are, accept the custom-app notice, and select Create. - Sign in with your VOYGR account. In a chat, select VOYGR Prospecting from the tools menu.
Ask ChatGPT to count and preview matches, then check the charge with you before paid work.
Codex
Run in your shell:
codex plugin marketplace add voygr-tech/prospecting
codex plugin add prospecting@prospecting
codex mcp login places
The last command opens browser sign-in. If Codex has no plugin command,
update Codex or use the API-key skill route below.
Skill only, with an API key
./install.sh copies skills/prospecting/SKILL.md into Claude Code's skills
directory. It does not connect the MCP server. You can also copy that file
to ~/.claude/skills/prospecting/SKILL.md or install it in Codex with
$skill-installer. For these routes, sign up at https://app.voygr.tech
and set VOYGR_API_KEY in the agent's environment:
export VOYGR_API_KEY=pk_live_...
One VOYGR account has one key and one credit balance for every VOYGR API.
If you already use PlaceCall, the
skill accepts PLACECALL_API_KEY as the same account key.
Other MCP clients (Cursor, Windsurf, MCP Inspector, ...)
Point the client at https://api.voygr.tech/places/mcp using streamable HTTP
transport and sign in with OAuth. This connects the places_* tools. In clients
without the Prospecting skill, ask the agent to count and preview matches and
check the charge with you before paid work.
Try it
Find 20 independent jewelers in Austin, TX. For each, get the owner's name and email and whether they sell lab-grown diamonds.
The agent counts and previews the query for free, explains charges for paid search, import, and enrichment, and asks before spending. For larger runs, the MCP server also returns a credit quote and asks for confirmation.
Build a qualified shortlist
Claude Chat, ChatGPT and other clients connected only to the MCP server may not load this repository's skill. Copy this prompt and replace the brackets:
Find candidate businesses in [US geography] in [categories] for [purpose]. A good fit must [criteria]. Use the VOYGR Prospecting tools. First, resolve the categories, count and preview the same search for free, and tell me what the filters can and cannot establish. Propose the smallest useful research fill, including one structured assessment field if it can cover my fit criteria. Show me the exact field instructions, current rates, daily assistant spend limit, the import quote and a fill estimate. Stop there. Do not start a paid action until I approve its scope and quote. After each approved step, verify the row count or job result before continuing. Get a fresh fill quote for the actual rows and fields before asking me to approve that job. Export every row, keep the original answers and empty or failed results, and make a review queue using my criteria. Flag unsupported claims and missing links. Treat the queue as candidates until someone checks sources, duplicates and contact routes.
A completed lookup can cost credits even when it returns no answer. Ask for a new quote if the scope changes or a quote expires. In a fresh chat after a plugin update, try the prompt through the free count, preview and proposed field first; review the result before approving any spend.
Use with PlaceCall
Build a list here, then have PlaceCall call the businesses on it (confirm details, ask a question, book). Both use your VOYGR account and credit balance.
API
Skill-only API requests go to https://api.voygr.tech with header X-API-Key;
CSV bytes go to the presigned upload URL without that header. The public
reference is at https://api.voygr.tech/docs; its prospecting coverage is still
being audited. Account-specific place and fill rates are at GET /v1/usage.
GET /v1/pricing does not cover search, list imports, or list fills.
License
MIT
VOYGR Prospecting MCP questions
How do I add VOYGR Prospecting MCP to Claude Code?
Run claude mcp add --transport http prospecting https://api.voygr.tech/places/mcp in your terminal. Add --scope user to make it available in every project.
How do I add VOYGR Prospecting MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How much does it cost to search for businesses?
Counting and five-place previews are free, while paid search and search-backed list imports charge per place.
Do I need an API key to connect to MCP clients?
No, you can sign in once in your browser and the server uses your VOYGR account and credit balance without needing to copy an API key.
Can I enrich lists with custom information?
Yes, you can enrich lists with owners, key people, email, phone, and any custom attribute described in plain English.
What happens if a field lookup finds no answer?
Completed field lookups can be charged even if no answer is found, though failed lookups are free.