Skip to content
MCP server

ListRiver

Search new and active U.S. businesses from state registries by state, ZIP and industry

Runs locallyStatus and history
Install
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-mcp

Add 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

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted 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
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data