DOCUMENTATION

MCP Intelligence — Developer Guide

Everything you need to connect, authenticate, and query 65+ intelligence tools.

QUICK START

Connect in under a minute

Three ways to connect. Pick the one that matches your setup.

Claude Desktop
Claude.ai (OAuth)
Direct JSON-RPC
claude_desktop_config.json
{
  "mcpServers": {
    "streaming-lens": {
      "url": "https://streaming-radar-mcp.streamingradar.workers.dev/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Add this to your Claude Desktop configuration file. Replace YOUR_API_KEY with your sl_live_ key. Free tools work without a key.

Server URL
https://streaming-radar-mcp.streamingradar.workers.dev

In Claude.ai: Settings MCP Servers Add Server paste the URL authenticate with your API key. OAuth 2.1 + PKCE handles the rest.

curl
curl -X POST https://streaming-radar-mcp.streamingradar.workers.dev/message \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"answer_question","arguments":{"question":"What is the SVOD market size in Africa?"}},"id":1}'

Standard MCP JSON-RPC over HTTP. Works with any HTTP client. All tools require an API key — free tier keys are available on request.

AUTHENTICATION

Three access tiers

Access is scoped by API key. All tiers require a key. Report data requires a subscriber key. Admin tools are invitation-only.

FREE

Free (free key)

Newsletter tools (sr_*), chart data (get_chart_data). 8 free tools. Free API key required.

SUBSCRIBER

Subscriber

Report intelligence (africa_*, vi_*), cross-report, competitive, trends, figures, export. Requires API key.

ADMIN

Admin

Full access + editorial tools, bulk ingest, webhooks, lead pipeline, usage analytics. By invitation only.

API KEY FORMAT & USAGE
Key format:  sl_live_ + 32 hex characters
Header:     Authorization: Bearer sl_live_xxxx...
Storage:    SHA-256 hashed server-side. Full key shown once at provisioning.
Scoping:    Keys are scoped to specific report slugs via entitlements.
TOOL CATALOG • 65+ TOOLS

All available tools

Click a category to expand. Click any tool name to copy it.

Newsletter

FREE
sr_get_articlesList newsletter articles with filters (tag, date, search)
sr_search_articlesFull-text search across all newsletter editions
sr_get_expertsList all indexed industry experts
sr_get_expertGet expert profile with linked articles
sr_get_tagsList all tags with article counts
sr_get_new_sinceGet articles published since a given date
sr_get_article_with_contextFull article with linked datapoints and expert context
sr_get_statsNewsletter aggregate statistics (admin)

Charts & Dataviz

FREE
get_chart_dataSilo-aware chart data for 9 types: silo_overview, category_breakdown, top_metrics, coverage, confidence, country, year_distribution, export_table, citation_graph

Africa Streaming

SUBSCRIBER
africa_get_datapointsQuery Africa streaming datapoints with filters
africa_get_companiesList companies in the Africa streaming landscape
africa_get_countriesCountry profiles with ASRI scores and metrics
africa_get_sourcesList research sources for Africa report
africa_compare_countriesSide-by-side comparison of two African markets
africa_get_country_briefComprehensive country brief with key indicators

Vertical Invasion

SUBSCRIBER
vi_get_datapointsQuery Vertical Invasion (micro-drama) datapoints
vi_get_companiesList companies in the micro-drama landscape
vi_get_countriesCountry profiles for micro-drama markets
vi_get_sourcesList research sources for Vertical Invasion report
vi_compare_countriesSide-by-side comparison of two micro-drama markets

Intelligence

SUBSCRIBER
answer_questionNatural language question -> cited datapoints (semantic + keyword search)
detect_trendsTrend detection across datapoints over time
get_data_provenanceFull source provenance chain for any datapoint
get_confidence_auditConfidence distribution audit across a silo
get_report_digestReport digest summary with key metrics
get_competitive_landscapeCompetitive landscape analysis for a market/segment
cross_report_compareCross-report metric comparison (Africa vs. VI)

Report Figures

SUBSCRIBER
get_report_figureGet a specific branded report figure (16 types: asri_radar, svod_graveyard, viable_models, etc.)
get_report_figuresList all available figures for a report silo

Contributions

SUBSCRIBER
submit_proposalSubmit a data correction or research proposal
list_proposalsList your submitted proposals and their status
watch_add_sourceSubmit a new source for review
watch_list_recentList recently added sources
update_sourceUpdate source metadata (admin)

Account

SUBSCRIBER
my_usageView your API usage stats and quota
my_digestGet your personalized intelligence digest
set_my_preferencesConfigure digest filters and notification preferences
get_schema_infoDatabase schema introspection

Export & Webhooks

SUBSCRIBER+
export_snapshotExport data snapshot to R2 (rate-limited)
admin_add_webhookRegister a webhook endpoint (HMAC-SHA256 signed)
admin_list_webhooksList registered webhook endpoints
admin_remove_webhookRemove a webhook endpoint

Admin

ADMIN
admin_ingest_bulkBulk insert datapoints (dry-run supported)
admin_manage_leadLead lifecycle management
get_lead_pipelineView lead pipeline status and scoring
db_statsRow counts for all database tables
watch_review_pendingReview pending source submissions
watch_approveApprove a pending source submission
watch_rejectReject a pending source submission
usage_get_statsUsage analytics across all API keys
search_top_queriesTop search queries and zero-result tracking

Editorial

ADMIN
sr_add_noteAdd an editorial note (idea, angle, quote, fact, todo, outline)
sr_list_notesList editorial notes with tag/type filters
sr_update_noteUpdate an existing editorial note
sr_clear_notesBatch delete notes (preview/confirm pattern)
sr_add_editorial_sourceAdd a dated editorial source (URL dedup)
sr_list_editorial_sourcesList editorial sources with used/unused indicator
sr_deactivate_sourceMark a source as inactive with reason
sr_mark_source_usedTrack source usage in a specific article
sr_prepare_briefAggregated notes + sources for article preparation
sr_extract_pdfExtract text from PDF (URL or R2), auto-create editorial source
DATA SILOS

Independent report databases

Each report is an isolated data silo, queried independently via the report_slug parameter.

Africa Streaming 2026

OTT market intelligence across 14 scored African markets. Revenue models, payment infrastructure, regulatory analysis, competitive landscape.

3,200+ datapoints 161 companies 14 countries 95+ sources
africa-streaming-2026

Vertical Invasion 2026

Micro-drama and short-form video intelligence. 27 chapters, global market data, platform analysis, IP economics, format migration frameworks.

27 chapters 11 annexes Global coverage 100+ sources
vertical-invasion-2026
RESPONSE FORMAT

What you get back

All responses follow the MCP JSON-RPC format. Every answer includes a watermark, confidence levels, and source attribution.

EXAMPLE RESPONSE
{
  "jsonrpc": "2.0",
  "result": {
    "content": [{
      "type": "text",
      "text": "## Africa SVOD Market\n\n**Market size**: $4.68B (2026)\n**Growth**: ->$6.27B by 2030\n**Subscribers**: 15.1M (1.1% penetration)\n\n*Source: Streaming Lens | ludovic@streaming-radar.com*"
    }]
  },
  "id": 1
}

Confidence Levels

VH Very High
H  High
M  Medium
L  Low
E  Estimated

Watermark

Every response includes a source attribution watermark: Source: Streaming Lens | ludovic@streaming-radar.com

Search Methods

Responses include a search_method field: semantic (Vectorize AI) or keyword (FTS5 fallback).

RATE LIMITS & CACHING

Usage constraints

Sliding window rate limiting via Cloudflare Durable Objects. Responses include Retry-After header on 429s.

Subscriber
60 req/min
Admin
120 req/min
Auth cache
300s
API key lookups cached for 5 minutes
Chart data cache
900s
Chart responses cached for 15 minutes
Schema cache
86,400s
Schema info cached for 24 hours
Country data cache
86,400s
Country profiles cached for 24 hours

Ready to connect?

Get an API key to unlock report intelligence. All tools require a key — free tier included.

Copied!