Aljazeera 360
About
MCP server for Al Jazeera 360 — Connect AI assistants to Al Jazeera's streaming catalog. Search, browse, and retrieve Arabic video content with direct watch links.
Details
- Author
- ahmedaminsa
- Categories
- Web Scraping, Media, Other, Search
Jump to
Setup
Install Aljazeera 360 in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/ahmedaminsa/aljazeera360-mcp-server
Follow the installation instructions in the repository README, then restart your MCP client.
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 toAl 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 toaljazeera360.comfor all content.
A hosted instance is live on Cloudflare. Add this to your MCP client config and you're done:
{ "mcpServers": { "aljazeera360": { "type": "http", "url": "https://aljazeera360-mcp.ahmed-26d.workers.dev/mcp" } } }
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:"ايه أحدث حلقات الدحيح؟"
- "What's trending on Al Jazeera 360?"
- "Find documentaries about Palestine"
- "Show me the latest episodes of Al Daheeh"
- "Search for videos about Gaza"
The AI connects to this server, fetches real data from Al Jazeera 360, and returns actual video titles, descriptions, durations, anddirect watch linkstoaljazeera360.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.
SEO & Metadata Tools (requiresAJ360_ENABLE_SEO_TOOLS=1)
Advanced AI & Analytics Tools (requiresAJ360_ENABLE_SEO_TOOLS=1)
git clone https://github.com/ahmedaminsa/aljazeera360-mcp-server.git cd aljazeera360-mcp-server pip install -r requirements.txt
The server supports multiple authentication methods (in priority order):
-
Refresh Token (Recommended)— Auto-refreshes every 10 minutes, valid for ~1 year:
export AJ360_REFRESH_TOKEN="eyJ..."
Auth Token— Direct token, expires in ~10 minutes:
export AJ360_AUTH_TOKEN="eyJ..."
Guest Mode— No configuration needed. The server auto-creates a guest session.
- Openhttps://www.aljazeera360.comin your browser
- Log in with your account
- Open DevTools → Console → Run:localStorage.getItem('dice:refreshToken')
- Copy the token value
Core tools are tested against the live API.
macOS:~/Library/Application Support/Claude/claude_desktop_config.json
Windows:%APPDATA%\Claude\claude_desktop_config.json
{ "mcpServers": { "aljazeera360": { "command": "python", "args": ["/full/path/to/aljazeera360-mcp-server/server.py"], "env": { "AJ360_REFRESH_TOKEN": "your-refresh-token-here" } } } }
Restart Claude Desktop. The Al Jazeera 360 tools will appear automatically.
This server speaks the standard MCP protocol overstdio(local) and Streamable HTTP (hosted). It works with any MCP-compatible client:
- Claude Desktop
- Cursor
- Continue
- Windsurf
- MCP Inspector(for testing)
- Any custom MCP client
The server needs onlyAJ360_API_KEYto run — authentication falls back to an automatic guest session. For full content access, also provide a refresh token.
The production instance runs onCloudflare Containers— full walkthrough indeploy/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.
docker build -t aljazeera360-mcp . docker run -p 8080:8080 -e MCP_TRANSPORT=streamable-http -e AJ360_REFRESH_TOKEN=your-token aljazeera360-mcp
gcloud builds submit --tag gcr.io/YOUR_PROJECT/aljazeera360-mcp gcloud 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"
Connect this repo — auto-deploys from the included Dockerfile. Set environment variables in the dashboard (includingAJ360_ALLOWED_HOST=<your-domain>so the DNS-rebinding protection accepts your host).
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) │ └──────────────────────────┘
The server includes pre-built prompts for common AI scenarios:
Callingsearch_videos("غزة")returns:
{ "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" } ] }
The server includes abuilt-in analytics dashboardthat tracks every request made by AI tools.
- Which AI tool made the request (Claude, ChatGPT, Cursor, etc.)
- Which MCP tool was called (search_videos,get_trending_content, etc.)
- When each request happened (timestamp)
- How long each request took (response time in ms)
- Whether it succeeded or failed
- Top search terms (what users are asking about)
- Daily/hourly activity patterns
The dashboard starts automatically on port9090when you run the server:
For cloud deployments, expose port 9090 alongside the MCP port (8080).
{ "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} ] }
SEO Ops & Vesper Knowledge Base (AI-assisted)
This repo doubles as an AI-assisted SEO operations workspace for the platform. Open it inClaude Codeand you get:
export AJ360_API_KEY=… python scripts/seo_snapshot.py # → reports/seo/<date>.md (local only)
PRs welcome. SeeCONTRIBUTING.mdfor guidelines.
Interact with the Bilibili video website, enabling actions like searching for videos, retrieving video information, and accessing user data.
A Model Context Protocol (MCP) server that enables AI applications to search and download audio resources from the Freesound platform via natural language commands.
YouTube data MCP server for AI agents to search videos, fetch transcripts, read comments, and inspect channels, playlists, and video details.
Access YouTube video data and transcripts using the YouTube Data API.
Extract metadata and captions from YouTube videos and convert them to markdown.
A zero-setup server to extract transcripts from YouTube videos on any platform.
A high-performance MCP server for fetching YouTube video transcripts, with support for caching, rate limiting, and proxy rotation.
Download video and audio content from various websites like YouTube, Facebook, and Tiktok using yt-dlp.
Download video and audio from various platforms like YouTube, Facebook, and TikTok using yt-dlp.
https://github.com/vamsi-kodimela/maagpi-youtube-mcp
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
