Iptv Org
FreeNot checkedFree linear TV: iptv-org discovery, health-filtered M3U playlists, EPG lookup, VLC + Jellyfin handoff. MCP server + Webapp
About
Free linear TV: iptv-org discovery, health-filtered M3U playlists, EPG lookup, VLC + Jellyfin handoff. MCP server + Webapp
README
FastMCP 3.4+ server for iptv-org: 8000+ public IPTV channels as searchable data + health-filtered M3U playlists. Solves the VLC dead-channel pain: filter by country/category, hide Geo-blocked/NSFW/blocklisted, optionally probe liveness, then play in VLC or import into Jellyfin Live TV.
Upstream stores no video, only public stream links (Unlicense/CC0). This server never proxies video. Blocklist + NSFW respected by default.
Quickstart
uv sync
copy .env.example .env
uv run pytest -q
uv run python -m iptv_org_mcp --serve --port 11242
Frontend:
cd web_sota
bun install
bun run dev
Or double-click start.bat (backend + frontend, ports 11242/11241).
Backend 11242, frontend 11241 (Vite dashboard: Channels, Playlists, EPG, Tools, Chat, Logs, Settings, Help). Health: http://127.0.0.1:11242/api/health.
MCP: http://127.0.0.1:11242/mcp (streamable HTTP) or stdio for Claude Desktop.
Claude Desktop
{
"mcpServers": {
"iptv-org": {
"command": "uv",
"args": ["run", "python", "-m", "iptv_org_mcp", "--mode", "stdio"],
"cwd": "D:/Dev/repos/iptv-org-mcp"
}
}
}
The VLC pain, fixed
iptv(operation="facets")- what countries/categories existiptv(operation="search_channels", query="ORF")- find, no dead weightiptv(operation="build_playlist", country="AT,DE", probe=true)- curated M3U URL- Paste URL into VLC (Media -> Open Network Stream) or
iptv(operation="play_in_vlc", channel_id="ORF1.at")on the same machine - Jellyfin:
iptv(operation="jellyfin_setup", country="AT")- M3U + XMLTV + steps
Docs
docs/ONBOARDING.md- no account needed (public CDN); VLC + Jellyfin setupdocs/TOOLS.md- all operations with examplesdocs/CONFIGURATION.md- env vars, cache, probe tuningINSTALL.md- naked-PC installdocs/TROUBLESHOOTING.md- dead streams, geo-blocks
Ports
| Port | Service |
|---|---|
| 11242 | Backend FastAPI + FastMCP /mcp |
| 11241 | Frontend (Vite dashboard) |
Registered in mcp-central-docs/operations/WEBAPP_PORTS.md.
Stack
Backend: Python 3.12+, FastMCP 3.4.x, FastAPI, uvicorn, httpx, pydantic v2,
prefab-ui. Frontend (web_sota/): React 19 + Vite 6 + TailwindCSS 3 +
Lucide + Framer Motion + Zustand + React Router, installed via Bun
(bun.lock committed; Node.js still required as Vite runs on Node).
Lint: ruff (T20) + pyright + biome + tsc. Tests: pytest (30% gate) + Playwright smoke.
MCP surface
Portmanteau iptv (12 ops: facets, search_channels, get_channel,
search_streams, check_streams, build_playlist, get_epg, jellyfin_setup,
play_in_vlc, status, refresh, help) plus iptv_shutdown, 2 prompts
(evening_news, match_night), 1 resource (resource://iptv-org/legal).
Legal
Only public links. blocklist.json (dmca/nsfw) enforced. See resource://iptv-org/legal.
MIT (this wrapper). Upstream: Unlicense/CC0.
Distribution (.mcpb bundle)
just mcpb-pack runs the fleet pack pipeline (wipe+recopy, import/AST/
pollution checks, 3-4-100 prompt gate, pack, launch-from-clean-unpack
proof) and writes dist/:
iptv-org-mcp-v0.2.1.mcpb- versioned archiveiptv-org-mcp.mcpb- stable name forreleases/latest/download/install.ps1- Claude Desktop one-liner installer (generated, SHA256-pinned)
Latest release (v0.2.1) carries all three assets. One-line install:
irm https://github.com/sandraschi/iptv-org-mcp/releases/latest/download/install.ps1 | iex
Install Iptv Org in Claude Desktop, Claude Code & Cursor
unyly install iptv-orgInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add iptv-org -- uvx --from git+https://github.com/sandraschi/iptv-org-mcp iptv-org-mcpStep-by-step: how to install Iptv Org
FAQ
Is Iptv Org MCP free?
Yes, Iptv Org MCP is free — one-click install via Unyly at no cost.
Does Iptv Org need an API key?
No, Iptv Org runs without API keys or environment variables.
Is Iptv Org hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Iptv Org in Claude Desktop, Claude Code or Cursor?
Open Iptv Org on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Notion
Read and write pages in your workspace
by NotionLinear
Issues, cycles, triage — from Claude
by LinearGoogle Drive
Search and read your Drive files
by Googlemindsdb/mindsdb
Connect and unify data across various platforms and databases with [MindsDB as a single MCP server](https://docs.mindsdb.com/mcp/overview).
by mindsdbfulcradynamics/fulcra-context-mcp
Access personal health and biometric data (sleep stages, heart rate, HRV, glucose, workouts), calendar and location via the Fulcra Life API.
by fulcradynamicsrinadelph/Agent-MCP
Framework for building multi-agent systems that coordinate over MCP, with task management, shared context and RAG.
by rinadelphWhenLabs-org/when
Developer toolkit: stack detection for AI context files, port conflicts, .env schema validation, docs drift, dependency license audits and task timing.
by WhenLabs-orgBeltran12138/wecom-docs-mcp-server
WeCom (Enterprise WeChat) document operations via MCP: create, read, and edit Docs and Smartsheets (9 tools). Fills the doc-CRUD gap — existing WeCom MCP server
by Beltran12138freema/mcp-gsheets
Google Sheets API integration for reading, writing, formatting and sheet management.
by freemamattijsdp/dbt-docs-mcp
dbt-core (OSS) project metadata, model and column-level lineage, and dbt documentation.
by mattijsdpCompare Iptv Org with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All productivity MCPs
