VOYGR Prospecting

Give your agent a lead list. Find US local businesses by city and category,then enrich them: owners and key people with email and phone, legal entity,open/closed status, hours, website, and any custom attribute you describe inplain English ("does this jeweler sell lab-grown diamonds").

16M+ US places
Count and five-place preview are free; paid search and search-backed listimports charge per place. Completed field lookups can be charged even whenno 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 theProspecting MCP server. Claude Chat,Cowork, ChatGPT, and other MCP clients can connect to the same server. Sign inonce 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 isavailable in Claude Chat, Cowork, and Claude Desktop after you sign in. You donot 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 Prospecting and enterhttps://api.voygr.tech/places/mcp as the URL. Keep the sign-in settingClaude 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 youbefore each paid search or lookup.

ChatGPT

Add VOYGR Prospecting as a custom MCP app in ChatGPT on the web. Custom appsdepend 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-appnotice, and select Create.
Sign in with your VOYGR account. In a chat, select VOYGR Prospecting fromthe tools menu.

Ask ChatGPT to count and preview matches, then check the charge with you beforepaid 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 skillsdirectory. It does not connect the MCP server. You can also copy that fileto ~/.claude/skills/prospecting/SKILL.md or install it in Codex with$skill-installer. For these routes, sign up at https://app.voygr.techand 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, theskill 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 HTTPtransport and sign in with OAuth. This connects the places_* tools. In clientswithout the Prospecting skill, ask the agent to count and preview matches andcheck the charge with you before paid work.

Try it

Find 20 independent jewelers in Austin, TX. For each, get the owner's nameand email and whether they sell lab-grown diamonds.

The agent counts and previews the query for free, explains charges for paidsearch, 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 maynot 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, resolvethe categories, count and preview the same search for free, and tell me whatthe filters can and cannot establish. Propose the smallest useful researchfill, including one structured assessment field if it can cover my fitcriteria. Show me the exact field instructions, current rates, dailyassistant 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 eachapproved step, verify the row count or job result before continuing. Get afresh fill quote for the actual rows and fields before asking me to approvethat job. Export every row, keep the original answers and empty or failedresults, and make a review queue using my criteria. Flag unsupported claimsand missing links.Treat the queue as candidates until someone checks sources, duplicates andcontact routes.

A completed lookup can cost credits even when it returns no answer. Ask for anew quote if the scope changes or a quote expires. In a fresh chat after aplugin update, try the prompt through the free count, preview and proposedfield first; review the result before approving any spend.

Use with PlaceCall

Build a list here, then have PlaceCallcall the businesses on it (confirm details, ask a question, book). Both useyour 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 publicreference is at https://api.voygr.tech/docs; its prospecting coverage is stillbeing 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