io.github.ahmedaminsaPublished by GitHub account ahmedaminsav2.5.0Updated Oct 24, 2026
Browse, search & watch Al Jazeera 360's Arabic shows, documentaries and podcasts inside the chat.
Connects an assistant to Al Jazeera 360's Arabic streaming catalog to search, browse and inspect shows, documentaries, series and episodes, with watch links.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.ahmedaminsa%2Faljazeera360-mcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"al-jazeera-360": {
"type": "http",
"url": "https://aljazeera360-mcp.ahmed-26d.workers.dev/mcp"
}
}
}[CI] [Python 3.10+] [License: MIT] [MCP Protocol] [Smithery]
Connect any AI assistant to Al Jazeera 360's streaming catalog — search, browse, and retrieve Arabic video content with direct watch links.
An MCP (Model Context Protocol) server that gives AI tools like Claude, ChatGPT, Gemini, and Cursor real-time access to Al Jazeera 360's full content library: documentaries, investigative programs, talk shows, podcasts, and original productions.
⚠️ Unofficial community project. Not affiliated with, endorsed by, or sponsored by Al Jazeera Media Network. It uses the platform's publicly accessible API and links back to
aljazeera360.comfor all content.
A hosted instance is live on Cloudflare. Add this to your MCP client config and you're done:
First request after idle takes a few seconds (container cold start) — subsequent requests are fast.
Then ask your assistant: "What's trending on Al Jazeera 360?" — or in Arabic: "ايه أحدث حلقات الدحيح؟"
Ask your AI assistant questions like:
The AI connects to this server, fetches real data from Al Jazeera 360, and returns actual video titles, descriptions, durations, and direct watch links to aljazeera360.com.
The server ships with two tool profiles:
A small default toolset keeps AI tool selection fast and accurate. Enable the full profile only if you need the SEO/analytics tools.
AJ360_ENABLE_SEO_TOOLS=1)AJ360_ENABLE_SEO_TOOLS=1)The server supports multiple authentication methods (in priority order):
Refresh Token (Recommended) — Auto-refreshes every 10 minutes, valid for ~1 year:
Auth Token — Direct token, expires in ~10 minutes:
Guest Mode — No configuration needed. The server auto-creates a guest session.
How to get your refresh token:
localStorage.getItem('dice:refreshToken')Core tools are tested against the live API.
Add to your config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Restart Claude Desktop. The Al Jazeera 360 tools will appear automatically.
This server speaks the standard MCP protocol over stdio (local) and Streamable HTTP (hosted). It works with any MCP-compatible client:
The server needs only AJ360_API_KEY to run — authentication falls back to an automatic guest session. For full content access, also provide a refresh token.
The production instance runs on Cloudflare Containers — full walkthrough in
deploy/cloudflare/README.md (wraps the Dockerfile in a
Cloudflare Container behind a tiny Worker; requires the Workers Paid plan and local
Docker for deploys). Any container platform works — alternatives below.
Connect this repo — auto-deploys from the included Dockerfile. Set environment variables in the dashboard (including AJ360_ALLOWED_HOST=<your-domain> so the DNS-rebinding protection accepts your host).
The server includes pre-built prompts for common AI scenarios:
Calling search_videos("غزة") returns:
The server includes a built-in analytics dashboard that tracks every request made by AI tools.
search_videos, get_trending_content, etc.)The dashboard starts automatically on port 9090 when you run the server:
For cloud deployments, expose port 9090 alongside the MCP port (8080).
MIT
This repo doubles as an AI-assisted SEO operations workspace for the platform. Open it in Claude Code and you get:
PRs welcome. See CONTRIBUTING.md for guidelines.
Run tests before submitting:
Source: README.md at commit f39ccd0
Get Trending Content (المحتوى الرائج)
Get the trending and most-watched content on Al Jazeera 360 platform. Returns featured shows, most-watched videos, latest episodes, and editorial picks. الحصول على المحتوى الرائج والأكثر مشاهدة على منصة الجزيرة 360. يشمل: البرامج المميزة، الأكثر مشاهدة، أحدث الحلقات، واقتراحات المحررين.
Takes no parameters.
Browse Section (تصفح الأقسام)
Browse content in a specific section/channel on Al Jazeera 360. تصفح محتوى قسم أو قناة محددة على منصة الجزيرة 360. Available sections (الأقسام المتاحة): - AJ360-Originals: أعمال الجزيرة 360 الأصلية - AJA: قناة الجزيرة العربية - AJD: الجزيرة الوثائقية - Atheer: أثير - AJ-Plus: AJ+ عربي - Talk Show: برامج حوارية - Investigative Show: برامج تحقيقية - Podcast: بودكاست - Documentaries: برامج وثائقية - Field Show: برامج ميدانية - Policy Series: سلاسل سياسية - Social Series: سلاسل اجتماعية - Historical Series: سلاسل تاريخية - Biographical Series: سلاسل سيرة ذاتية - Culture and Arts Series: سلاسل ثقافة وفنون Args: section_id: The section identifier (e.g., "AJA", "Documentaries", "Podcast")
section_idrequiredGet Video Details (تفاصيل الفيديو)
Get detailed information about a specific video on Al Jazeera 360. Returns title, description, duration, quality, categories, episode info, and watch URL. الحصول على معلومات تفصيلية عن فيديو محدد على منصة الجزيرة 360. يشمل: العنوان، الوصف، المدة، الجودة، التصنيفات، ورابط المشاهدة. Args: video_id: The numeric ID of the video (e.g., 953659)
video_idrequiredPlay Video (تشغيل الفيديو)
Play a video from Al Jazeera 360. In AI apps that support interactive views (MCP Apps), this opens the official Al Jazeera 360 player inside the chat; elsewhere it returns the watch link. Use when the user asks to watch or play something. تشغيل فيديو من الجزيرة 360. في التطبيقات التي تدعم الواجهات التفاعلية يفتح المشغّل الرسمي داخل المحادثة، وفي غيرها يعيد رابط المشاهدة. Args: video_id: The numeric ID of the video (from search_videos, browse_section, etc.)
video_idrequiredPlayback Diagnostics (فحص التشغيل)
Check whether this AI app can play Al Jazeera 360 videos inside the chat (protected video / DRM, embedding the official player, fullscreen). Use when the user says a video does not play in the chat. Call it with no arguments; the interactive view runs the checks and shows the result. فحص قدرة تطبيق الذكاء الاصطناعي على تشغيل فيديوهات الجزيرة 360 داخل المحادثة. استخدمها عندما يقول المستخدم إن الفيديو لا يعمل داخل المحادثة. Args: report: Internal. Filled by the interactive view with its capability check; leave empty.
reportGet Series Details (تفاصيل البرامج والسلاسل)
Get detailed information about a series on Al Jazeera 360, including all seasons. الحصول على معلومات تفصيلية عن مسلسل/برنامج على منصة الجزيرة 360 مع قائمة المواسم. Args: series_id: The numeric ID of the series (e.g., 2355 for الدحيح)
series_idrequiredGet Season Episodes (حلقات الموسم)
Get all episodes in a specific season. Use get_series_details first to find season IDs. الحصول على جميع حلقات موسم محدد. استخدم get_series_details أولاً للحصول على أرقام المواسم. Args: season_id: The season ID (obtained from get_series_details) max_episodes: Maximum number of episodes to return (default: 20)
season_idrequiredmax_episodesSearch Videos (البحث عن الفيديوهات)
Search for videos, documentaries, and programs on Al Jazeera 360. Supports Arabic and English search queries. Optionally filter by content type. البحث عن فيديوهات ووثائقيات وبرامج على منصة الجزيرة 360. يدعم البحث بالعربية والإنجليزية. يمكن تصفية النتائج حسب نوع المحتوى. Examples: - "فلسطين" — videos about Palestine - "غزة" — videos about Gaza - "الدحيح" — Al Daheeh science show - "وثائقي تاريخي" — historical documentaries Args: query: Search term in Arabic or English content_type: Optional filter — "VOD" for single videos, "SERIES" for series only, None for all max_results: Maximum number of results to return (default: 20)
queryrequiredmax_resultscontent_typeList Sections (قائمة الأقسام المتاحة)
List all available sections and channels on Al Jazeera 360. Returns section IDs with their Arabic names for use with browse_section. عرض جميع الأقسام والقنوات المتاحة على منصة الجزيرة 360. يرجع معرفات الأقسام مع أسمائها العربية لاستخدامها مع browse_section.
Takes no parameters.
Get Latest Episodes (أحدث الحلقات)
Get the latest episodes from a specific section on Al Jazeera 360. الحصول على أحدث الحلقات من قسم محدد على منصة الجزيرة 360. Args: section_id: Section to get latest from (default: "AJA" for Al Jazeera Arabic) count: Number of episodes to return (default: 10)
countsection_idShow on Screen (اعرض على الشاشة)
Open the interactive Al Jazeera 360 view (the site's look: rows, programme pages, episode page, player) in the conversation. Use it ONLY when the user explicitly asks to see or display something on screen or to play an episode here (e.g. «اعرضلي»، «وريني»، «شغّلها هنا», "show me", "display", "play it here"). For everything else, use the other tools, which return data only. فتح العرض التفاعلي للجزيرة 360 داخل المحادثة، فقط عندما يطلب المستخدم العرض صراحةً. Args: view: home | section | latest | search | series | season | video | play video_id: For video or play series_id: For series season_id: For season section_id: For section or latest (e.g. "AJA", "AJD") query: For search
viewrequiredqueryvideo_idseason_idseries_idsection_idWatch Video (مشاهدة الفيديو)
Look at an Al Jazeera 360 episode: returns timestamped frames (one every ~15 s is available) as images, so you can see scenes, people and read on-screen text such as guest names and titles, news tickers and quotes. Use it to describe an episode, find who appears or when something is shown, or to build chapters and metadata. For long episodes, look at the whole range first, then zoom into a range. Afterwards, save_video_analysis stores what you found so it becomes searchable. مشاهدة حلقة من الجزيرة 360: صور من الحلقة بتوقيتها لقراءة النصوص على الشاشة ومعرفة الضيوف والمشاهد. Args: video_id: Video ID (from search_videos, get_season_episodes, ...) start_minute: Start of the range, in minutes (default 0) end_minute: End of the range, in minutes (default: end of the episode) max_frames: Frames to return, 4-36 (default 24; 12 per image)
video_idrequiredend_minutemax_framesstart_minuteSearch Video Index (البحث داخل الحلقات)
Search inside analysed episodes: who appeared, when a topic came up, what was said or shown on screen. Returns episodes with the timestamps of each match; for speech the exact second the phrase is spoken (exact_sec, from word timings). Covers episodes saved with save_video_analysis or transcribed with listen_to_video / transcribe_audio. البحث داخل الحلقات المحللة: مين ظهر، وإمتى اتكلموا عن موضوع، وإيه اللي اتقال أو اتكتب. Args: query: Name, topic or phrase (Arabic or English) kind: all | people (guests + mentions) | guest | mention | chapter | topic | keyword | onscreen | transcript | transcript_en (English translation) limit: Max matches (default 40)
kindlimitqueryrequiredGet Video Analysis (تحليل الحلقة المحفوظ)
Read the saved analysis of an episode (summary, chapters, guests, topics, ad breaks, name fixes, on-screen text) or list all analysed episodes when no video_id is given. The transcript lines are left out unless include_transcript is true: use get_transcript for the text, or the download links. عرض التحليل المحفوظ لحلقة (الملخص والفصول والضيوف…)، أو قائمة كل الحلقات المحللة. Args: video_id: Video ID (omit to list analysed episodes) include_transcript: Also return every transcript/translation line (large; default false)
video_idinclude_transcriptGet Transcript (نص الحلقة والترجمة)
Get the full text of an episode: the platform's own subtitle file (WebVTT/SRT) when the episode has one, otherwise a transcript already saved in the video index. Returns the text with timestamps, plain text, or a ready SRT/VTT file. If neither exists, says so and lists the subtitle languages that are available. On the team endpoint, saved transcripts also come with download links (text, SRT, VTT) to the full file. نص الحلقة الكامل: ملف الترجمة الخاص بالمنصة إن وجد، أو التفريغ المحفوظ في الفهرس. Args: video_id: Video ID language: Subtitle language code (default "ar"; falls back to another language if absent) format: text (timestamped lines) | plain | srt | vtt start_minute: Start of the range, in minutes (default 0) end_minute: End of the range (default: end of the episode)
formatlanguagevideo_idrequiredend_minutestart_minute100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
{ "mcpServers": { "aljazeera360": { "type": "http", "url": "https://aljazeera360-mcp.ahmed-26d.workers.dev/mcp" } }}git clone https://github.com/ahmedaminsa/aljazeera360-mcp-server.gitcd aljazeera360-mcp-serverpip install -r requirements.txtexport AJ360_REFRESH_TOKEN="eyJ..."export AJ360_AUTH_TOKEN="eyJ..."python test_server.pypython server.py{ "mcpServers": { "aljazeera360": { "command": "python", "args": ["/full/path/to/aljazeera360-mcp-server/server.py"], "env": { "AJ360_REFRESH_TOKEN": "your-refresh-token-here" } } }}docker build -t aljazeera360-mcp .docker run -p 8080:8080 -e MCP_TRANSPORT=streamable-http -e AJ360_REFRESH_TOKEN=your-token aljazeera360-mcpgcloud builds submit --tag gcr.io/YOUR_PROJECT/aljazeera360-mcpgcloud run deploy aljazeera360-mcp \ --image gcr.io/YOUR_PROJECT/aljazeera360-mcp \ --platform managed \ --allow-unauthenticated \ --set-env-vars="MCP_TRANSPORT=streamable-http,AJ360_REFRESH_TOKEN=your-token"Your AI Assistant │ │ MCP Protocol (stdio / Streamable HTTP) ▼┌──────────────────────────┐│ This MCP Server ││ ┌────────────────────┐ ││ │ Token Manager │ ││ │ (auto-refresh) │ ││ ├────────────────────┤ ││ │ 24 Tools + Prompts │ ││ │ + Retry + Cache │ ││ └────────────────────┘ │└──────────┬───────────────┘ │ │ HTTPS (authenticated) ▼┌──────────────────────────┐│ Al Jazeera 360 API ││ (Vesper/Dice Platform) │└──────────┬───────────────┘ │ ▼┌──────────────────────────┐│ aljazeera360.com ││ (Direct watch links) │└──────────────────────────┘{ "query": "غزة", "total_results": 20, "results": [ { "title": "المسعفون أهداف إسرائيل المتنقلة!", "type": "VOD", "duration": "24:53", "id": "965741", "watch_url": "https://www.aljazeera360.com/video/965741" }, { "title": "قيادة السنوار لجهاز حماس الأمني", "type": "VOD", "duration": "54:57", "id": "953659", "watch_url": "https://www.aljazeera360.com/video/953659" } ]}http://localhost:9090{ "total_requests": 1247, "success_rate": "99.2%", "tools_usage": [ {"tool": "search_videos", "calls": 523, "avg_response_ms": 340}, {"tool": "get_trending_content", "calls": 312, "avg_response_ms": 180} ], "clients": [ {"client": "claude-desktop", "requests": 890}, {"client": "cursor", "requests": 357} ], "top_searches": [ {"term": "\u063a\u0632\u0629", "count": 89}, {"term": "\u0641\u0644\u0633\u0637\u064a\u0646", "count": 67} ]}export AJ360_API_KEY=…python scripts/seo_snapshot.py # → reports/seo/<date>.md (local only)python test_server.py