ListRiver

io.github.ListRiver-LLCPublished by GitHub account ListRiver-LLCv0.1.0Updated Nov 7, 2026

Search new and active U.S. businesses from state registries: new LLCs by state, city, ZIP, NAICS.

VerifiedSTDIODesktop only

Overview

ListRiver's local MCP server; no sign-in required; STDIO; 3 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

  1. Open ListRiver in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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):

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

Claude Code:

bash
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:

bash
pip install ./python ./mcpLISTRIVER_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.

Source: mcp/README.md at commit 7ea090c

Tools

3

list_states

List the states ListRiver covers, with how many businesses each has: formed this month or last ("recent"), in the last 12 months ("year"), and every active business ("all"). Free.

Takes no parameters.

count_businesses

Count businesses matching the filters, per state. Free: use it before search_businesses. Args: states: Comma-separated two-letter registration states, e.g. "FL" or "FL,TX". Required with city, county or zip. city: Comma-separated business cities, e.g. "MIAMI". county: Comma-separated counties, e.g. "MIAMI-DADE" (or "FL:MIAMI-DADE"). zip: Comma-separated 5-digit ZIP codes or 3-digit ZIP prefixes, e.g. "33139,331". naics: Comma-separated NAICS prefixes, 2-6 digits, e.g. "23" (construction) or "722511". entity_type: Comma-separated of LLC, CORP, LP, LLP, NONPROFIT, OTHER. has_phone: Only businesses with a phone number on file. has_email: Only businesses with an email on file. formed_within: Formed in the current month or the N months before it (1 = this month or last). Set 0 for any formation date. formed_from: First formation month, "YYYY-MM" (overrides formed_within). formed_to: Last formation month, "YYYY-MM" (overrides formed_within).

Parameterszipcitynaicscountystatesformed_tohas_emailhas_phoneentity_typeformed_fromformed_within

search_businesses

Get businesses matching the filters (same filters as count_businesses). USES THE USER'S RECORDS: each business returned counts, every time it is returned, so ask only for what the user needs. Args: states: Comma-separated two-letter registration states. Required with city, county or zip. city: Comma-separated business cities. county: Comma-separated counties. zip: Comma-separated 5-digit ZIP codes or 3-digit prefixes. naics: Comma-separated NAICS prefixes, 2-6 digits. entity_type: Comma-separated of LLC, CORP, LP, LLP, NONPROFIT, OTHER. has_phone: Only businesses with a phone number on file. has_email: Only businesses with an email on file. formed_within: Formed in the current month or the N months before it (1 = this month or last; 0 = any date). formed_from: First formation month, "YYYY-MM". formed_to: Last formation month, "YYYY-MM". limit: How many businesses to return, 1-100 (default 25). cursor: The cursor from a previous search_businesses answer, to get the next businesses of the same search.

Parameterszipcitylimitnaicscountycursorstatesformed_tohas_emailhas_phoneentity_typeformed_from+1 more

Version history

1
  1. v0.1.0LatestNov 3, 2026

Score

80% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.