listriver-mcp 0.1.0__tar.gz

listriver_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: listriver-mcp
+Version: 0.1.0
+Summary: MCP server for ListRiver: let Claude and other AI assistants search new U.S. businesses from state registries.
+Author-email: ListRiver LLC <support@listriver.com>
+License: MIT
+Project-URL: Homepage, https://listriver.com/api-docs
+Project-URL: Source, https://github.com/ListRiver-LLC/listriver-api
+Project-URL: Get a free API key, https://listriver.com/Account/ApiSignUp.aspx
+Keywords: mcp,model context protocol,claude,business data,secretary of state,new businesses,b2b leads,kyb
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Office/Business
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp<3,>=2.3
+Requires-Dist: listriver>=0.1.0
+
+# ListRiver MCP server
+
+<!-- mcp-name: io.github.ListRiver-LLC/listriver -->
+
+Lets Claude and other AI assistants search **new and active U.S. businesses from official state business registries**
+through [ListRiver](https://listriver.com/api-docs): 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
+
+| Tool | What it does | Cost |
+|---|---|---|
+| `list_states` | States covered and their record counts | free |
+| `count_businesses` | How many businesses match a search, per state | free |
+| `search_businesses` | The 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](https://listriver.com/Account/ApiSignUp.aspx)
+2. Install [uv](https://docs.astral.sh/uv/getting-started/installation/) (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`.
+
+## 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](https://listriver.com/legal/listriver-api-eula.txt)).
+- More: [API documentation](https://listriver.com/api-docs) - [support@listriver.com](mailto:support@listriver.com)
+
+MIT license.

listriver_mcp-0.1.0/README.md

@@ -0,0 +1,63 @@
+# ListRiver MCP server
+
+<!-- mcp-name: io.github.ListRiver-LLC/listriver -->
+
+Lets Claude and other AI assistants search **new and active U.S. businesses from official state business registries**
+through [ListRiver](https://listriver.com/api-docs): 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
+
+| Tool | What it does | Cost |
+|---|---|---|
+| `list_states` | States covered and their record counts | free |
+| `count_businesses` | How many businesses match a search, per state | free |
+| `search_businesses` | The 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](https://listriver.com/Account/ApiSignUp.aspx)
+2. Install [uv](https://docs.astral.sh/uv/getting-started/installation/) (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`.
+
+## 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](https://listriver.com/legal/listriver-api-eula.txt)).
+- More: [API documentation](https://listriver.com/api-docs) - [support@listriver.com](mailto:support@listriver.com)
+
+MIT license.

listriver_mcp-0.1.0/listriver_mcp/__init__.py

@@ -0,0 +1,2 @@
+"""ListRiver MCP server. https://github.com/ListRiver-LLC/listriver-api/tree/main/mcp"""
+__version__ = "0.1.0"

listriver_mcp-0.1.0/listriver_mcp/__main__.py

@@ -0,0 +1,3 @@
+from .server import main
+
+main()

listriver_mcp-0.1.0/listriver_mcp/server.py

@@ -0,0 +1,186 @@
+"""ListRiver MCP server: lets AI assistants search new and active U.S. businesses from state registries.
+
+Run with `uvx listriver-mcp` and set LISTRIVER_API_KEY (free key: https://listriver.com/Account/ApiSignUp.aspx).
+"""
+from __future__ import annotations
+
+import os
+from typing import Any, Dict, List, Optional
+
+from listriver import AuthError, BadRequest, Client, ListRiverError, OutOfRecords
+from mcp.server.mcpserver import MCPServer
+from mcp.types import ToolAnnotations
+
+KEY_URL = "https://listriver.com/Account/ApiSignUp.aspx"
+MAX_SEARCH = 100
+
+INSTRUCTIONS = f"""ListRiver has active U.S. businesses from official state business registries (new LLCs, corporations,
+nonprofits, partnerships), with address, county, registered agent, formation month and, where available, phone, email,
+website, EIN and NAICS industry.
+
+How to use these tools well:
+- count_businesses is free. Call it first to see how many businesses match before searching.
+- search_businesses uses the user's ListRiver records: every business returned counts, each time it is returned.
+  Ask for only as many as the user needs (default 25, at most {MAX_SEARCH} per call), and don't repeat the same search.
+  To get more of the same search, pass the cursor from the previous answer.
+- city, county and zip need states. Formation dates are month-level (formed_within counts whole calendar months).
+- Phone, email, NAICS and county are on file for only part of the records, and coverage varies by state:
+  use has_phone / has_email / naics with count_businesses to check before promising them.
+- Data is for the user's own business use; it may not be used for credit, insurance, employment or housing decisions."""
+
+READ_ONLY = ToolAnnotations(readOnlyHint=True, idempotentHint=True, openWorldHint=True)
+
+server = MCPServer(
+    name="ListRiver",
+    title="ListRiver business registry data",
+    instructions=INSTRUCTIONS,
+    website_url="https://listriver.com/api-docs",
+    version="0.1.0",
+)
+
+_client: Optional[Client] = None
+
+
+def _get_client() -> Client:
+    global _client
+    if _client is None:
+        key = (os.environ.get("LISTRIVER_API_KEY") or "").strip()
+        if not key:
+            raise ListRiverError(401, f"LISTRIVER_API_KEY is not set. Get a free key at {KEY_URL} and add it to this MCP server's environment.")
+        _client = Client(key)
+    return _client
+
+
+def _filters(states, city, county, zip, naics, entity_type, has_phone, has_email, formed_within, formed_from, formed_to) -> Dict[str, Any]:
+    return dict(states=states, city=city, county=county, zip=zip, naics=naics, entity_type=entity_type,
+                has_phone=has_phone, has_email=has_email, formed_within=formed_within,
+                formed_from=formed_from, formed_to=formed_to)
+
+
+def _error(e: ListRiverError) -> Dict[str, Any]:
+    hint = None
+    if isinstance(e, AuthError):
+        hint = f"Check LISTRIVER_API_KEY. A free key is at {KEY_URL}."
+    elif isinstance(e, OutOfRecords):
+        hint = "The user's records are used up. They can buy a pack or plan at https://listriver.com/Account/Api.aspx (count_businesses is still free)."
+    elif isinstance(e, BadRequest):
+        hint = "Fix the parameter the message names and try again."
+    return {"ok": False, "status": e.status, "error": e.message, "hint": hint}
+
+
+@server.tool(annotations=READ_ONLY)
+def list_states() -> Dict[str, Any]:
+    """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."""
+    try:
+        return {"ok": True, "states": _get_client().states()}
+    except ListRiverError as e:
+        return _error(e)
+
+
+@server.tool(annotations=READ_ONLY)
+def count_businesses(
+    states: Optional[str] = None,
+    city: Optional[str] = None,
+    county: Optional[str] = None,
+    zip: Optional[str] = None,
+    naics: Optional[str] = None,
+    entity_type: Optional[str] = None,
+    has_phone: bool = False,
+    has_email: bool = False,
+    formed_within: Optional[int] = 1,
+    formed_from: Optional[str] = None,
+    formed_to: Optional[str] = None,
+) -> Dict[str, Any]:
+    """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).
+    """
+    try:
+        f = _filters(states, city, county, zip, naics, entity_type, has_phone, has_email,
+                     _window(formed_within, formed_from, formed_to), formed_from, formed_to)
+        if f["formed_within"] is None and not formed_from and not formed_to:
+            f["preset"] = "all"
+        return {"ok": True, **_get_client().count(**f)}
+    except ListRiverError as e:
+        return _error(e)
+
+
+@server.tool(annotations=READ_ONLY)
+def search_businesses(
+    states: Optional[str] = None,
+    city: Optional[str] = None,
+    county: Optional[str] = None,
+    zip: Optional[str] = None,
+    naics: Optional[str] = None,
+    entity_type: Optional[str] = None,
+    has_phone: bool = False,
+    has_email: bool = False,
+    formed_within: Optional[int] = 1,
+    formed_from: Optional[str] = None,
+    formed_to: Optional[str] = None,
+    limit: int = 25,
+    cursor: Optional[str] = None,
+) -> Dict[str, Any]:
+    """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.
+    """
+    try:
+        f = _filters(states, city, county, zip, naics, entity_type, has_phone, has_email,
+                     _window(formed_within, formed_from, formed_to), formed_from, formed_to)
+        if f["formed_within"] is None and not formed_from and not formed_to:
+            f["preset"] = "all"
+        page = _get_client().page(limit=max(1, min(MAX_SEARCH, int(limit))), cursor=cursor, **f)
+        return {
+            "ok": True,
+            "count": len(page.rows),
+            "businesses": page.rows,
+            "cursor": page.cursor,
+            "more": page.has_more,
+            "records_left_this_period": page.monthly_remaining,
+            "pack_records_left": page.credits_remaining,
+        }
+    except ListRiverError as e:
+        return _error(e)
+
+
+def _window(formed_within: Optional[int], formed_from: Optional[str], formed_to: Optional[str]) -> Optional[int]:
+    if formed_from or formed_to:
+        return None
+    if formed_within is None or int(formed_within) <= 0:
+        return None
+    return int(formed_within)
+
+
+def main() -> None:
+    server.run("stdio")
+
+
+if __name__ == "__main__":
+    main()

listriver_mcp-0.1.0/listriver_mcp.egg-info/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: listriver-mcp
+Version: 0.1.0
+Summary: MCP server for ListRiver: let Claude and other AI assistants search new U.S. businesses from state registries.
+Author-email: ListRiver LLC <support@listriver.com>
+License: MIT
+Project-URL: Homepage, https://listriver.com/api-docs
+Project-URL: Source, https://github.com/ListRiver-LLC/listriver-api
+Project-URL: Get a free API key, https://listriver.com/Account/ApiSignUp.aspx
+Keywords: mcp,model context protocol,claude,business data,secretary of state,new businesses,b2b leads,kyb
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Office/Business
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp<3,>=2.3
+Requires-Dist: listriver>=0.1.0
+
+# ListRiver MCP server
+
+<!-- mcp-name: io.github.ListRiver-LLC/listriver -->
+
+Lets Claude and other AI assistants search **new and active U.S. businesses from official state business registries**
+through [ListRiver](https://listriver.com/api-docs): 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
+
+| Tool | What it does | Cost |
+|---|---|---|
+| `list_states` | States covered and their record counts | free |
+| `count_businesses` | How many businesses match a search, per state | free |
+| `search_businesses` | The 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](https://listriver.com/Account/ApiSignUp.aspx)
+2. Install [uv](https://docs.astral.sh/uv/getting-started/installation/) (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`.
+
+## 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](https://listriver.com/legal/listriver-api-eula.txt)).
+- More: [API documentation](https://listriver.com/api-docs) - [support@listriver.com](mailto:support@listriver.com)
+
+MIT license.

listriver_mcp-0.1.0/listriver_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+listriver_mcp/__init__.py
+listriver_mcp/__main__.py
+listriver_mcp/server.py
+listriver_mcp.egg-info/PKG-INFO
+listriver_mcp.egg-info/SOURCES.txt
+listriver_mcp.egg-info/dependency_links.txt
+listriver_mcp.egg-info/entry_points.txt
+listriver_mcp.egg-info/requires.txt
+listriver_mcp.egg-info/top_level.txt
+tests/test_server.py

listriver_mcp-0.1.0/listriver_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

listriver_mcp-0.1.0/listriver_mcp.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+listriver-mcp = listriver_mcp.server:main

listriver_mcp-0.1.0/listriver_mcp.egg-info/requires.txt

@@ -0,0 +1,2 @@
+mcp<3,>=2.3
+listriver>=0.1.0

listriver_mcp-0.1.0/listriver_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+listriver_mcp

listriver_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "listriver-mcp"
+version = "0.1.0"
+description = "MCP server for ListRiver: let Claude and other AI assistants search new U.S. businesses from state registries."
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "ListRiver LLC", email = "support@listriver.com" }]
+requires-python = ">=3.10"
+dependencies = ["mcp>=2.3,<3", "listriver>=0.1.0"]
+keywords = ["mcp", "model context protocol", "claude", "business data", "secretary of state", "new businesses", "b2b leads", "kyb"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Topic :: Office/Business",
+]
+
+[project.scripts]
+listriver-mcp = "listriver_mcp.server:main"
+
+[project.urls]
+Homepage = "https://listriver.com/api-docs"
+Source = "https://github.com/ListRiver-LLC/listriver-api"
+"Get a free API key" = "https://listriver.com/Account/ApiSignUp.aspx"
+
+[tool.setuptools]
+packages = ["listriver_mcp"]

listriver_mcp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

listriver_mcp-0.1.0/tests/test_server.py

@@ -0,0 +1,78 @@
+import asyncio
+import json
+
+import pytest
+
+from listriver import OutOfRecords, Page
+import listriver_mcp.server as srv
+
+
+class FakeClient:
+    def __init__(self):
+        self.calls = []
+
+    def states(self):
+        self.calls.append(("states", {}))
+        return [{"code": "FL", "name": "Florida", "recent": 10, "year": 100, "all": 1000}]
+
+    def count(self, **f):
+        self.calls.append(("count", f))
+        return {"total": 7, "states": [{"code": "FL", "count": 7}], "approximate": True}
+
+    def page(self, limit, cursor=None, **f):
+        self.calls.append(("page", dict(f, limit=limit, cursor=cursor)))
+        return Page(rows=[{"businessName": "A LLC"}], cursor="FL.5", resume="FL.5", monthly_remaining=499, credits_remaining=0)
+
+
+@pytest.fixture
+def fake(monkeypatch):
+    c = FakeClient()
+    monkeypatch.setattr(srv, "_client", c)
+    return c
+
+
+def call(name, args):
+    result = asyncio.run(srv.server.call_tool(name, args))
+    text = result.content[0].text
+    return json.loads(text)
+
+
+def test_tools_are_listed_and_read_only():
+    tools = {t.name: t for t in asyncio.run(srv.server.list_tools())}
+    assert set(tools) == {"list_states", "count_businesses", "search_businesses"}
+    assert all(t.annotations.read_only_hint for t in tools.values())
+    assert "USES THE USER'S RECORDS" in tools["search_businesses"].description
+
+
+def test_count_passes_filters(fake):
+    out = call("count_businesses", {"states": "FL", "city": "MIAMI", "has_phone": True, "formed_within": 3})
+    assert out["ok"] and out["total"] == 7
+    name, f = fake.calls[0]
+    assert name == "count" and f["states"] == "FL" and f["city"] == "MIAMI" and f["has_phone"] is True and f["formed_within"] == 3
+
+
+def test_any_formation_date_uses_preset_all(fake):
+    call("count_businesses", {"states": "FL", "formed_within": 0})
+    assert fake.calls[0][1]["preset"] == "all" and fake.calls[0][1]["formed_within"] is None
+
+
+def test_search_caps_the_limit_and_returns_cursor(fake):
+    out = call("search_businesses", {"states": "FL", "limit": 5000, "cursor": "FL.1"})
+    assert out["count"] == 1 and out["cursor"] == "FL.5" and out["more"] is True and out["records_left_this_period"] == 499
+    assert fake.calls[0][1]["limit"] == 100 and fake.calls[0][1]["cursor"] == "FL.1"
+
+
+def test_out_of_records_gives_a_hint(monkeypatch):
+    class Broke(FakeClient):
+        def page(self, limit, cursor=None, **f):
+            raise OutOfRecords(429, "Your free 500 records for this month are used up.")
+    monkeypatch.setattr(srv, "_client", Broke())
+    out = call("search_businesses", {"states": "FL"})
+    assert out["ok"] is False and out["status"] == 429 and "Account/Api.aspx" in out["hint"]
+
+
+def test_missing_key_explains_how_to_get_one(monkeypatch):
+    monkeypatch.setattr(srv, "_client", None)
+    monkeypatch.delenv("LISTRIVER_API_KEY", raising=False)
+    out = call("list_states", {})
+    assert out["ok"] is False and "ApiSignUp.aspx" in out["error"]