Provides tools for searching podcasts, exploring episodes, browsing categories, and retrieving podcast metadata from the Podcast Index API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Oremi Kànsà search for podcasts about space exploration"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Oremi Kànsà is an MCP server for discovering podcasts through the Podcast Index. It provides AI assistants and autonomous agents with a standardized interface to search, browse, and retrieve podcast information using the Model Context Protocol (MCP).
Designed to run in Docker, Oremi Kànsà exposes tools for searching podcasts, exploring episodes, browsing categories, and retrieving metadata from Podcast Index. It enables MCP-compatible clients to access podcast content without interacting directly with the Podcast Index API.
The name Oremi Kànsà comes from the Yoruba language. Oremi means "my friend", reflecting the project's goal of building a helpful and trustworthy AI ecosystem. Kànsà is derived from the Yoruba word associated with broadcasting or broadcast media, representing the service's responsibility for helping AI agents discover podcast content through a unified MCP interface.
Search and discover podcasts by topic, language, and category
Retrieve detailed podcast and episode metadata
Browse categories, trending shows, and related podcasts
Return structured, validated response models for MCP clients
Use either the public Podcast Index API or the offline SQLite catalog
Accelerate searches with persistent FTS5 indexes and a bounded memory cache
Persist and periodically refresh the catalog in /oremi/data in Docker
Run with multiple Docker Swarm replicas against the same cluster-shared volume
Configure database updates, HTTP timeouts, 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.
Related MCP server: Podcast Index MCP
All project documentation—including architecture details, configuration reference, and the Home Assistant integration guide—can be found at: https://demsking.gitlab.io/oremi-kansa/
Oremi Kànsà 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.
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
Copyright 2026 Sébastien Demanou. All Rights Reserved.
Licensed under the Apache License, Version 2.0. See the LICENSE for the complete license text.
This server cannot be deployed
Podcast Index MCP — wraps the Podcast Index API (podcastindex.org)
An MCP server that provides tools to discover and retrieve podcast episodes transcripts.
Podcast search, metadata, chapters, and transcripts for AI agents — from $15/mo
Search and play AI-hosted podcasts; preview launching your agent's own show.
