FIPS County Code Lookup — 3,231 US Counties

by easysolutions906

274 downloads
Not rated
GitHub

About

Look up US county FIPS codes. Search by code, county name, or state. 3,231 counties. Used by mortgage, title, GIS, and government platforms.

Details

Author
easysolutions906
Downloads
274
Categories
Developer Tools

- Lookup county by 5-digit FIPS code.
- Search counties by name with optional state filter.
- List all counties in a state by FIPS code or abbreviation.
- Retrieve database statistics and county counts per state.
- Supports both stdio (MCP) and HTTP (REST API) transports.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name FIPS County Code Lookup — 3,231 US Counties
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via npx @easysolutions906/mcp-fips and configure the server in your MCP client’s configuration file (e.g., claude_desktop_config.json or .cursor/mcp.json). Four MCP tools are available: fips_lookup, fips_search, fips_state, and fips_stats. Optionally, set the PORT environment variable to run the server in HTTP mode, which provides REST endpoints for lookups, search, state listing, batch operations, and statistics.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "fips county code lookup \u2014 3,231 us counties": {
            "fips": {
                "command": "npx",
                "args": [
                    "-y",
                    "@easysolutions906/mcp-fips"
                ]
            }
        }
    }
}

McpServers

{
    "fips": {
        "command": "npx",
        "args": [
            "-y",
            "@easysolutions906/mcp-fips"
        ]
    }
}

MCP FIPS Server

A Model Context Protocol (MCP) server for looking up US counties by FIPS code, name, or state. Covers all 50 states, DC, and territories.

Tools (4 total)

| Tool | Description | |------|-------------| | fips_lookup | Look up a county by its 5-digit FIPS code | | fips_search | Search counties by name, optionally filtered by state | | fips_state | List all counties in a state by FIPS code or abbreviation | | fips_stats | Get database statistics: total counties, states, and counts by state |

Install

``bash npx @easysolutions906/mcp-fips `

Claude Desktop

Add to your
claude_desktop_config.json: `json { "mcpServers": { "fips": { "command": "npx", "args": ["-y", "@easysolutions906/mcp-fips"] } } } `

Cursor

Add to
.cursor/mcp.json: `json { "mcpServers": { "fips": { "command": "npx", "args": ["-y", "@easysolutions906/mcp-fips"] } } } `

REST API

Set
PORT env var to run as an HTTP server. - GET /lookup?fips=06037 -- look up county by FIPS code - GET /search?name=los+angeles&state=CA -- search counties by name - GET /state/:code -- list all counties in a state (e.g., /state/CA) - POST /lookup/batch -- batch lookup multiple FIPS codes - GET /stats -- county counts by state

Data Source

US Census Bureau FIPS county codes. Run
npm run build-data to regenerate from the latest Census data.

Transport

- stdio (default) -- for local use with Claude Desktop and Cursor - HTTP -- set
PORT env var to start in Streamable HTTP mode on /mcp`
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.