# ListRiver

> ListRiver is a freemium MCP server for sales and crm. Search new and active U.S. businesses from state registries by state, ZIP and industry. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://listriver.com/api-docs
- **Repository:** https://github.com/listriver-llc/listriver-api/tree/HEAD/mcp
- **MCP Registry name:** io.github.ListRiver-LLC/listriver
- **Categories:** sales and CRM, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add listriver --env LISTRIVER_API_KEY='<LISTRIVER_API_KEY>' -- uvx listriver-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "listriver": {
      "command": "uvx",
      "args": [
        "listriver-mcp"
      ],
      "env": {
        "LISTRIVER_API_KEY": "<LISTRIVER_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "listriver": {
      "command": "uvx",
      "args": [
        "listriver-mcp"
      ],
      "env": {
        "LISTRIVER_API_KEY": "<LISTRIVER_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "listriver": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "listriver-mcp"
      ],
      "env": {
        "LISTRIVER_API_KEY": "<LISTRIVER_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "listriver": {
      "command": "uvx",
      "args": [
        "listriver-mcp"
      ],
      "env": {
        "LISTRIVER_API_KEY": "<LISTRIVER_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "listriver": {
      "command": "uvx",
      "args": [
        "listriver-mcp"
      ],
      "env": {
        "LISTRIVER_API_KEY": "<LISTRIVER_API_KEY>"
      }
    }
  }
}
```

## Tools

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

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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/listriver
