mcpField
L
ListRiver

ListRiver

Local
listriver.comBusiness & Marketing0Updated 5d ago
RepositoryVisit website

About ListRiver

ListRiver is an MCP server for searching new and active businesses in official U.S. state registries. It serves AI assistants that need location, industry, entity-type, or formation-date filters, with free counts available before retrieving records.

Key features

  1. 01Search new and active businesses
  2. 02Filter by state, city, county, and ZIP
  3. 03Filter by NAICS, entity type, and formation month
  4. 04Check whether phone or email is on file
  5. 05Count matches and retrieve paginated results

Use cases

  1. 01Find newly formed construction companies in a county
  2. 02Count recent businesses with a phone number
  3. 03Find new LLCs in a ZIP and inspect registered agents

MCP support

Exposes list_states, count_businesses, and search_businesses tools for MCP clients to query ListRiver business records.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "listriver-llc-listriver": {
      "command": "uvx",
      "args": [
        "listriver-mcp"
      ],
      "env": {
        "LISTRIVER_API_KEY": "<LISTRIVER_API_KEY>"
      }
    }
  }
}
Run commanduvx listriver-mcp
Environment variables to set
LISTRIVER_API_KEYSecretYour ListRiver API key (free, 500 records a month: https://listriver.com/Account/ApiSignUp.aspx)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypilistriver-mcp0.1.0

Tools

3

Saved tool list · updated 1w ago

This tool takes no parameters.

Details

From the project README

ListRiver MCP server

Lets Claude and other AI assistants search new and active U.S. businesses from official state business registries through ListRiver: new LLCs, corporations and nonprofits by state, city, county, ZIP, NAICS industry, entity type, formation month, and whether a phone or email is on file.

Ask things like:

  • "How many businesses were formed in Miami-Dade in the last 3 months that have a phone number?"
  • "Find 20 new construction companies in Harris County, Texas."
  • "List new LLCs in ZIP 80202 formed this month, with their registered agents."

Tools

ToolWhat it doesCost
list_statesStates covered and their record countsfree
count_businessesHow many businesses match a search, per statefree
search_businessesThe matching businesses (25 by default, up to 100 per call; cursor for more)each business returned counts against your ListRiver records

The assistant is told to count first and to ask only for as many businesses as you need.

Setup

  1. Get a free API key (500 records a month): listriver.com/Account/ApiSignUp.aspx
  2. Install uv (it runs the server with uvx, no other install needed).
  3. Add the server to your AI app.

Claude Desktop (Settings > Developer > Edit Config, then restart Claude Desktop):

{
  "mcpServers": {
    "listriver": {
      "command": "uvx",
      "args": ["listriver-mcp"],
      "env": { "LISTRIVER_API_KEY": "lr_key_..." }
    }
  }
}

Claude Code:

claude mcp add listriver -e LISTRIVER_API_KEY=lr_key_... -- uvx listriver-mcp

Other MCP clients: run uvx listriver-mcp (stdio) with LISTRIVER_API_KEY in the environment. Or pip install listriver-mcp and run listriver-mcp.

Source

The server is listriver_mcp/server.py in this folder (Python, built on the official MCP Python SDK, using the listriver client from this repository). Tests: tests/test_server.py.

Run from a clone of the repository:

pip install ./python ./mcp
LISTRIVER_API_KEY=lr_key_... listriver-mcp

or build the Dockerfile at the repository root: docker build -t listriver-mcp . then docker run -i --rm -e LISTRIVER_API_KEY=lr_key_... listriver-mcp.

Notes

  • Every business returned counts against your records each time it is returned; repeated or overlapping searches count again. Counting is free.
  • Phone, email, NAICS and county are on file for only part of the records, and coverage varies by state.
  • The data is for your own business use, not for resale or for credit, insurance, employment or housing decisions (ListRiver API agreement).
  • More: API documentation - [email protected]

MIT license.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.