---
slug: "agents-agents-sdk-telegram"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/esakrissa/agents-sdk-telegram@main/README.md"
repo: "https://github.com/esakrissa/agents-sdk-telegram"
source_file: "README.md"
branch: "main"
---
# Weather Bot with OpenAI Agents SDK

A Telegram bot that provides real-time weather information using OpenAI's Agents SDK and Model Context Protocol (MCP). The bot can fetch current weather conditions for cities worldwide using natural language queries, powered by GPT-4o-mini model.

## Features

- Real-time weather data using Open-Meteo API
- Natural language processing with OpenAI Agents SDK (GPT-4o-mini)
- Simple MCP server implementation for weather data retrieval
- Telegram-native message formatting
- Easy-to-use interface with simple weather queries

## Technology Stack

- Python 3.11+
- OpenAI Agents SDK
- Model Context Protocol (MCP)
- python-telegram-bot
- Open-Meteo API (no API key required)

## Quick Start

1. Clone the repository:
```bash
git clone https://github.com/esakrissa/agents-sdk-telegram.git
cd agents-sdk-telegram
```

2. Create and activate a virtual environment:
```bash
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
```

3. Install dependencies:
```bash
pip install -r requirements.txt
```

4. Create a .env file in the project root:
```bash
TELEGRAM_BOT_TOKEN=your_bot_token_here
OPENAI_API_KEY=your_openai_api_key_here
```

5. Run the bot:
```bash
python main.py
```

## Usage

Simply send a message to the bot asking about weather in any city:
```
what's the weather in Ubud?
```

The bot will respond with current weather conditions including:
- Temperature
- Weather conditions
- Wind speed

## Architecture

### OpenAI Agents SDK Integration
The bot uses OpenAI's Agents SDK with GPT-4o-mini model to process natural language queries and generate human-like responses. The Agent is configured with specific instructions for handling weather-related queries and maintaining conversation context.

### Model Context Protocol (MCP)
The project implements a simple MCP server (`weather_mcp.py`) that provides the `get_weather` tool. This demonstrates how to:
- Create custom MCP tools
- Handle tool requests and responses
- Integrate external APIs (Open-Meteo) with MCP

## License

MIT © Esa Krissa