Weather MCP Server for Intercom

Custom Model Context Protocol (MCP) server that integrates weather tools with Intercom.

🎯 What This Is

This project demonstrates how to build a custom MCP server that integrates with Intercom. Use it as a template for:

• Learning MCP development with real-world examples

• Building your own tools by replacing weather APIs with your data sources

• Product demos showing MCP capabilities

Related MCP server: Claude-NWS Protocol Bridge

🚀 Quick Start

1. Read the setup guide: SETUP_GUIDE.md

2. Start the server: uv run weather.py

🛠️ What It Provides

Weather Tools for Intercom Fin

• greet - Personalized customer greetings

• get_alerts - Real-time weather alerts for US states

• get_forecast - Detailed weather forecasts by coordinates

Technical Features

• Real-time data from National Weather Service API

• HTTP transport via ngrok tunneling

• Async operations for optimal performance

• Error handling with graceful fallbacks

📋 Files Overview

• weather.py - Main MCP server implementation

• SETUP_GUIDE.md - Complete setup instructions for team

• pyproject.toml - Python project configuration

⚠️ Important Note

Due to MCP SDK bug #423, you may need to apply a simple patch to enable tool discovery. This bug may be fixed in future SDK releases. Full instructions in the setup guide.

🔧 Tech Stack

• FastMCP - MCP server framework

• Python 3.11+ - Runtime environment

• httpx - HTTP client for weather API

• ngrok - HTTP tunneling

📚 Learn More

• FastMCP Documentation: https://gofastmcp.com/getting-started/installation

• MCP Server Development: https://modelcontextprotocol.io/quickstart/server

Created by: Oséas Filho