Skip to main content

A Model Control Protocol (MCP) server that provides US zipcode lookup functionality. It can be used to decode zipcodes into city and state information.

Project description

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

{
    "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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zipcode_decoder_mcp-0.1.3.tar.gz (19.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

zipcode_decoder_mcp-0.1.3-py3-none-any.whl (2.3 kB view details)

Uploaded Python 3

File details

Details for the file zipcode_decoder_mcp-0.1.3.tar.gz.

File metadata

  • Download URL: zipcode_decoder_mcp-0.1.3.tar.gz
  • Upload date:
  • Size: 19.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.13

File hashes

Hashes for zipcode_decoder_mcp-0.1.3.tar.gz
Algorithm Hash digest
SHA256 637490dad3fb8e789642f19834ce9a248e84a5255cd23d5eeb6b68714f620edc
MD5 d99ee48025805aba809e09ac330e69eb
BLAKE2b-256 f8130cd05df214167b5f74924a09977f1e4418bc0eeabc16214752ceac96cfb5

See more details on using hashes here.

File details

Details for the file zipcode_decoder_mcp-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for zipcode_decoder_mcp-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 a8bb220d5e7a4d73a59fe37c067ee38fd705abafeddc041bd9870ea9d8aaef49
MD5 36522282b4505e37688393a4e934c305
BLAKE2b-256 bf23b02d42a2d7aba266cd67a87957494a0195a6e6c38394bcfb9393b2c1c36f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page