ListRiver
Search new and active U.S. businesses from state registries by state, ZIP and industry
- Pricing
- Freemium
- Platforms
- API, CLI
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- 3 days ago
About ListRiver
ListRiver is a freemium MCP server for sales and crm. It runs locally on your machine and is started by your AI client.
The server draws on official state business registries through the ListRiver API and is meant for lead lists and market research on newly formed companies. Searches can narrow by state, city, county, ZIP, NAICS industry, entity type, formation month, and whether a phone number or email is on file. Returned records can include registered agents.
It exposes three tools: one lists the states covered, one counts matches, and one returns the matching businesses, 25 by default and up to 100 per call, with a cursor for more. Counting is free; every business returned counts against your monthly records each time it is returned, so repeated or overlapping searches use more. The assistant is told to count first and request only as many as needed.
Running it needs a ListRiver API key and uv, which launches the Python package over stdio. Phone, email, NAICS and county are present for only some records, coverage varies by state, and the data licence bars resale and use for credit, insurance, employment or housing decisions.
Install
Run in a terminal
claude mcp add listriver --env LISTRIVER_API_KEY='<LISTRIVER_API_KEY>' -- uvx listriver-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"listriver": {
"command": "uvx",
"args": [
"listriver-mcp"
],
"env": {
"LISTRIVER_API_KEY": "<LISTRIVER_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"listriver": {
"command": "uvx",
"args": [
"listriver-mcp"
],
"env": {
"LISTRIVER_API_KEY": "<LISTRIVER_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"listriver": {
"type": "stdio",
"command": "uvx",
"args": [
"listriver-mcp"
],
"env": {
"LISTRIVER_API_KEY": "<LISTRIVER_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"listriver": {
"command": "uvx",
"args": [
"listriver-mcp"
],
"env": {
"LISTRIVER_API_KEY": "<LISTRIVER_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"listriver": {
"command": "uvx",
"args": [
"listriver-mcp"
],
"env": {
"LISTRIVER_API_KEY": "<LISTRIVER_API_KEY>"
}
}
}
}Configuration
LISTRIVER_API_KEYYour ListRiver API key (free, 500 records a month: https://listriver.com/Account/ApiSignUp.aspx)Required
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- list_states
- Lists the states covered with their record counts.
- count_businesses
- Counts businesses matching a search, per state.
- search_businesses
- Returns matching businesses, 25 by default and up to 100 per call.
What it does
- Count before fetching
- count_businesses reports matches per state without using records.
- Rich filters
- Filters by state, city, county, ZIP, NAICS, entity type and formation month.
- Contact-on-file filter
- Limits results to businesses with a phone or email on file.
- Paged results
- Returns 25 businesses by default, up to 100 per call, with a cursor.
- State coverage list
- list_states shows which states are covered and their record counts.
- Runs locally
- A Python package launched with uvx over stdio.
Good for
- Find new construction companies in a county
- Count LLCs formed in a ZIP code this month
- Build a prospect list of businesses with phone numbers
- Research formation trends by state or industry
- Look up registered agents for new entities
Pricing
Freemium
Free key with 500 records a month; higher volumes not priced in the README
Prices change. Check listriver.com before you buy.
ListRiver FAQ
Do I need an API key?
Yes. A free key gives 500 records a month.
What does a search cost?
Counting is free. Each business returned counts against your records, again every time it is returned.
How do I run it?
Install uv, set LISTRIVER_API_KEY, and run uvx listriver-mcp, or pip install listriver-mcp.
Can I resell the data?
No. The README says it is for your own business use, not for resale or decisions about credit, insurance, employment or housing.
What licence is the server under?
MIT.
Is ListRiver free?
ListRiver has a free plan, with paid plans for more usage or features.
How do I add ListRiver to Claude Code?
Run this command in your terminal: claude mcp add listriver --env LISTRIVER_API_KEY='<LISTRIVER_API_KEY>' -- uvx listriver-mcp
What are the best alternatives to ListRiver?
The closest alternatives to ListRiver are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.
Alternatives to ListRiver

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
Not checked yet- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data