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

    "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.1.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.1-py3-none-any.whl (2.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: zipcode_decoder_mcp-0.1.1.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.1.tar.gz
Algorithm Hash digest
SHA256 1560e8feadf43ce87d3e3cfac84eb2c80766aeef71e8baf5f3cb88db63cc2fa1
MD5 4a161049d791c4219c93bbc6384ac5c7
BLAKE2b-256 655eea3a88d1dfc0e0eb7040ea6d317621494c7aed3fbaa26e253676a7c0c2f6

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for zipcode_decoder_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 861c1120cfb8125e3e0b7c64ebb51aef4d1e7ed0bf1e4e417e0a5a16178ba14c
MD5 f44a35dc2a8b421a715eaaff1c1e35cd
BLAKE2b-256 c168be0aaa4dbffba4eed162652f85add5b65b54ee85a1944c3cec64e356e7b2

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