Metadata-Version: 2.4
Name: zipcode-decoder-mcp
Version: 0.1.2
Summary: A Model Control Protocol (MCP) server that provides US zipcode lookup functionality. It can be used to decode zipcodes into city and state information.
Author-email: Yang <superfyca@gmail.com>
Requires-Python: >=3.13
Requires-Dist: mcp[cli]>=1.12.3
Requires-Dist: requests>=2.31.0
Description-Content-Type: text/markdown

# Zipcode Decoder MCP

A Model Control Protocol (MCP) server that provides US zipcode lookup functionality. This server allows AI assistants to retrieve city and state information from US zipcodes using the Ziptastic API.

## Features

- **Zipcode Lookup**: Convert US zipcodes to city and state information
- **MCP Integration**: Built using the FastMCP framework for easy integration with MCP-compatible clients
- **Error Handling**: Robust error handling for network issues and invalid responses
- **Lightweight**: Simple, focused implementation with minimal dependencies

## MCP server configuration
```json
    "zipcode-decoder-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "zipcode-decoder-mcp"
      ]
    }
```

## Example

User prompt: Which city does zipcode 31999 belong to?

Expected answer: Columbus, GA
