Name: ListRiver
Author: listriver-llc

ListRiver MCP

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

Grade A Local · stdio API key 3 tools v0.1.0 MIT

No reviews yet by listriver-llcPyPI 350 Runs on your machine, nothing hosted

100/100

trust score

downloads a day

local

runs on your machine

downloads in 30d

What it does

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

Quickstart

# 1 — add it to Claude Code
claude mcp add --scope user --env 'LISTRIVER_API_KEY=${LISTRIVER_API_KEY}' --transport stdio listriver-mcp '--' uvx listriver-mcp

# 2 — ask your agent for something these tools do
#   list_states, count_businesses, search_businesses

It needs LISTRIVER_API_KEY: this reads it from your environment, so export it first.

ListRiver costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.

Publishernot claimed

listriver-llc1 server

1 category

All 1 server

Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.

Installation

Where are you running it?

Every route below installs the same thing and ends at the same approval screen. This one runs on your machine: your client starts ListRiver as a process under your own user, with your files and your network, so the tool surface below is what it can do to your computer rather than to a server somewhere else. Its scan result is on the Security tab — read the surface before you approve it.

Claude Codedeclared by this listing

This is a public server: you run it yourself and this marketplace is not in the path. You need uv (docs.astral.sh/uv): uvx comes with it. Claude Code registers it in one command; --scope user makes it available in every project. Claude Code reads LISTRIVER_API_KEY (Your ListRiver API key (free, 500 records a month: https://listriver.com/Account/ApiSignUp.aspx)) from your environment each time it starts the server, so the value stays out of its config: export it in your shell profile (macOS, Linux), or run setx LISTRIVER_API_KEY … and open a new terminal (Windows). The '--' is in quotes so that PowerShell passes it on.

claude mcp add --scope user --env 'LISTRIVER_API_KEY=${LISTRIVER_API_KEY}' --transport stdio listriver-mcp '--' uvx listriver-mcp

Reconnect, or start a new session, and the tools appear in the model’s tool list.

Free on mcprush, and it runs from its publisher’s own package: this marketplace is not in the path, so there is no key of ours to hold and no card to add.

What it asks of you

It reaches a system of yours, so it needs your own credential rather than the publisher’s: LISTRIVER_API_KEY — Your ListRiver API key (free, 500 records a month: https://listriver.com/Account/ApiSignUp.aspx). You set it in your own client’s config, on your machine — this marketplace never holds it.

What it writes

One config entry your client uses to start the process locally. A local server runs with your file system and your network, which is why it is priced without metering.

What you approve

3 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.

Tool surface

What the model actually sees. Descriptions are diffed on every release — see version history.

Only tools that write or reach the network

Read from its source code. A server that builds its tool list when it starts can list more tools than this.

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 matching the filters, per state. Free: use it before search_businesses.

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

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.

Parameter	Type	Required	Notes
states	string	no	Comma-separated two-letter registration states. Required with city, county or zip.
city	string	no	Comma-separated business cities.
county	string	no	Comma-separated counties.
zip	string	no	Comma-separated 5-digit ZIP codes or 3-digit prefixes.
naics	string	no	Comma-separated NAICS prefixes, 2-6 digits.
entity_type	string	no	Comma-separated of LLC, CORP, LP, LLP, NONPROFIT, OTHER.
has_phone	boolean	no	Only businesses with a phone number on file.
has_email	boolean	no	Only businesses with an email on file.
formed_within	integer	no	Formed in the current month or the N months before it (1 = this month or last; 0 = any date).
formed_from	string	no	First formation month, "YYYY-MM".
formed_to	string	no	Last formation month, "YYYY-MM".
limit	integer	no	How many businesses to return, 1-100 (default 25).
cursor	string	no	The cursor from a previous search_businesses answer, to get the next businesses of the same search.

Free

$0 forever

Every tool, no call limit
No card, and mcprush charges nothing for it
Source published under MIT
Runs on your machine — nothing of it reaches our gateway
Nothing to cap, because mcprush bills nothing

Nothing here is billable: mcprush charges nothing to install ListRiver or to call it, at any volume.

ATrust score 100 / 100

Release 0.1.0 · scanned 4 Nov 2026

Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.

Threat score100

Client score100

Findings0 threat · 0 capability

Capabilityminimal

Coveragesource

Verificationsource

Surface digest2c5dfd5fb61020743155e5a614eae30634ccbaae2eeed8e949718aba89f84fa7

Score vectorthreat 100 → client 100

Term	Level	What it prices	Points
capability-exposure	minimal	capability blast radius (minimal) — client exposure if the model is manipulated	−0
verification-discount	source	publisher verification (provenance) — cryptographic build provenance ties the artifact to its source	−0
coverage-honesty	source	inspection depth (source) — how much of the target the scan could see	−0

score = clamp(round(threatScore − E_cap − E_ver − E_cov), 0, 100). No model, no opinion, no network call at scoring time: the same methodology version against the same bytes always produces this number, and every line above is a field of the report rather than a summary of it.

What the scan could actually read

A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.

Tool surfaceread

Implementation sourceread

Package metadataread

Live transportnot available

Tools were statically extracted from the published source (3 recovered), not enumerated from a running server. Tool-poisoning, Unicode-smuggling, capability and toxic-flow analysis ran on this inferred surface, but a mis-parsed registration could be missed or mis-attributed, so tool-derived findings are capped below “confirmed”. To grade the real runtime surface, scan the running server: --command "npx -y <package>".

Capability — what it could do if the model were manipulated

Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. minimal is the level these add up to.

Tool	Capability tags	Why the tag was assigned
list_states	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
count_businesses	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
search_businesses	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)

Toxic-flow graph

The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.

The public result for this release does not print the flow graph, so there is nothing to show here. That is not the same as "no paths were found": what the scan did read is above, under coverage.

Supply chain and provenance

Integrityfirst-seen

Surface digest2c5dfd5fb6102074

Scanned2026-11-04

This is the first scan of this surface here, so there is nothing yet to compare it against.

Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.