Oremi Rediyo

Oremi Rediyo is an MCP server for internet radio streaming. It provides AI assistants and autonomous agents with a unified interface to discover, search, and play radio stations from around the world through the Model Context Protocol (MCP).

Built to run in Docker, Oremi Rediyo offers reliable access to thousands of internet radio stations, allowing agents to browse stations by name, country, language, genre, or popularity, and control playback using a standardized MCP interface.

The name Oremi Rediyo comes from the Yoruba language. Oremi means "my friend", reflecting the project's goal of building a helpful and trustworthy AI ecosystem. Rediyo is the Yoruba word for "radio", representing the service's responsibility for discovering and streaming internet radio stations through a unified MCP interface.

Core Capabilities

• Search by station name, UUID, codec, country, country code, state, language, or tag
• Return complete station metadata, including the preferred stream URL
• Browse countries, languages, and tags with station counts
• Inspect Radio Browser service statistics
• Register a Radio Browser click when playback starts
• Configure timeouts, result limits, broken-station filtering, HTTP binding, API prefix, and logging through environment variables
• Serve MCP over Streamable HTTP
• Run as a lightweight Docker container with simple deployment.
• Integrate seamlessly with the Oremi ecosystem and other MCP-compatible clients.

Documentation

All project documentation—including architecture details, configuration reference, and the Home Assistant integration guide—can be found at: https://demsking.gitlab.io/oremi-rediyo/

Development

Oremi Rediyo is built with Python and uses uv for dependency management. The project follows standard Python development practices with type hints, linting, and automated testing.

For detailed information on setting up your development environment, running tests, code style guidelines, and the pull request process, please refer to CONTRIBUTING.md.

Versioning

This project adheres to Semantic Versioning (SemVer). Version numbers follow the MAJOR.MINOR.PATCH format:

• MAJOR version increments for incompatible API changes
• MINOR version increments for backward-compatible new functionality
• PATCH version increments for backward-compatible bug fixes

License

Copyright 2026 Sébastien Demanou. All Rights Reserved.

Licensed under the Apache License, Version 2.0. See the LICENSE for the complete license text.