@matchuplabs/nycfhv-mcp

MCP server that exposes the NYC FHV Intelligence API — TLC for-hire-vehicle license verification and renewal-window lookups — as Claude / OpenAI agent tools.

Tools

| Tool | What it does | Cost | |---|---|---| | verify_tlc_vehicle | Verify an FHV by TLC license, DMV plate, or VIN. Returns active status, expiration, base, WAV flag. | 1 credit | | list_upcoming_renewals | Vehicles whose license expires in the next N days. Filters: base, WAV, max model year. | 5 credits / page |

Quickstart

1. Get an API key at matchuplabs.com (product: fhv-intelligence).
2. Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "nycfhv": {
      "command": "npx",
      "args": ["-y", "@matchuplabs/nycfhv-mcp"],
      "env": {
        "FHV_API_KEY": "mv_live_your_key_here"
      }
    }
  }
}

3. Restart Claude Desktop. The two tools appear in the tool picker.

Environment

| Variable | Required | Default | |---|---|---| | FHV_API_KEY | Yes | — | | FHV_BASE_URL | No | https://fhv.matchup.dev |

Why this exists

Apps and AI agents that touch NYC for-hire transportation today can't verify a TLC license without scraping a manual portal. This MCP wraps a commercial-grade verification API so an agent can confirm "is this vehicle currently TLC-active?" as a single tool call before authorizing a livery rate, dispatching a Medicaid NEMT trip, or pre-binding insurance.

Data source: NYC TLC's daily-refreshed For-Hire Vehicles - Active dataset. Public record under NY State FOIL.

Development

npm install
FHV_API_KEY=mv_test_xxx npm run dev    # stdio server, requires a real key
npm run build
npm test

License

MIT. © Matchup Labs.