MCP.so
Sign In

Weather Bot with OpenAI Agents SDK

@esakrissa

About Weather Bot with OpenAI Agents SDK

Telegram bot using OpenAI Agents SDK and MCP Server.

Basic information

Category

Developer Tools

Runtime

python

Transports

stdio

Publisher

esakrissa

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "agents-sdk-telegram": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is 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). It processes natural language queries to fetch current weather conditions for cities worldwide, powered by GPT-4o-mini and the Open-Meteo API. Designed for users who want conversational weather updates through Telegram.

How to use Weather Bot with OpenAI Agents SDK?

Clone the repository, set up a Python 3.11+ virtual environment, install dependencies, and create a .env file with your Telegram bot token and OpenAI API key. Run python main.py then send a message like "what's the weather in Ubud?" to the bot on Telegram. The bot replies with temperature, conditions, and wind speed.

Key features of Weather Bot with OpenAI Agents SDK

  • Real-time weather via Open-Meteo API (no key required)
  • Natural language processing with GPT-4o-mini
  • Simple MCP server for weather data retrieval
  • Telegram-native message formatting
  • Easy-to-use interface with plain text queries

Use cases of Weather Bot with OpenAI Agents SDK

  • Quickly check current weather in any city via Telegram
  • Integrate weather lookups into a conversational AI agent
  • Demonstrate MCP server integration with OpenAI Agents SDK
  • Provide weather information without external API keys (Open-Meteo)

FAQ from Weather Bot with OpenAI Agents SDK

Does it require an API key for weather data?

No. The bot uses the Open-Meteo API, which does not require an API key.

What are the runtime requirements?

Python 3.11+, an OpenAI API key (for GPT-4o-mini), and a Telegram bot token from BotFather.

Where does the bot run?

Locally on your machine or server after installation. The MCP server runs as part of the bot process.

How does the bot understand natural language?

It uses OpenAI's Agents SDK with the GPT-4o-mini model to process queries and generate responses.

What transport or authentication is used?

The bot uses the Telegram API (HTTPS) and the OpenAI API (HTTPS with key). The MCP server runs locally without external transport.

Comments

More Developer Tools MCP servers