Metadata-Version: 2.4
Name: zipcode-decoder-mcp
Version: 0.1.3
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: Yang
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
{
    "mcpServers": {
    	"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
