{"schema_version":"2026-07-02","name":"Asha News","description":"Evidence-first news intelligence","homepage":"https://asha.news","contact":"agents@asha.news","api":{"base":"https://asha.news/api/v1","openapi":"https://asha.news/api/v1/openapi","readiness":"https://asha.news/api/v1/readiness","auth":{"public_read":"no_key_required","user":"clerk_bearer"},"rate_limits":{"public_read":"shared pool, 1000 requests / 15 min per IP","note":"Poll /api/v1/breaking at 60s with If-None-Match; briefs cache for 60s."}},"mcp":{"status":"public_native_mcp_available","endpoint":"https://asha.news/api/v1/mcp","transport":"jsonrpc-http","protocol_version":"2024-11-05","supported_protocol_versions":["2024-11-05","2025-03-26","2025-06-18"],"capabilities":["tools","resources","prompts"],"auth":"none_public_read","recommendation":"POST JSON-RPC 2.0 to /api/v1/mcp (initialize, tools/list, tools/call, resources/list, resources/read, prompts/list, prompts/get). OpenAPI remains available for non-MCP clients."},"notifications":{"breaking_poll":"GET https://asha.news/api/v1/breaking (60s interval, ?since= deltas, If-None-Match/304)","breaking_push":{"register":"POST https://asha.news/api/v1/webhooks {\"url\":\"https://...\",\"events\":[\"breaking\"]}","auth":"agent_key_bearer (issued by POST /api/v1/agents/signup)","signature":"X-Asha-Signature: sha256=HMAC_SHA256(secret, raw_body)","requirements":"Public https URL; 5 active webhooks per key; disabled after 10 consecutive failures.","test":"POST https://asha.news/api/v1/webhooks/{id}/test"}},"resources":{"openapi":"https://asha.news/api/v1/openapi","readiness":"https://asha.news/api/v1/readiness","mcp":"https://asha.news/api/v1/mcp","reader":"https://asha.news/feed","search":"https://asha.news/api/v1/search?q={topic}","sources":"https://asha.news/sources","short_link_status":"https://asha.news/api/v1/short-links/{key}","share_links":"https://asha.news/api/v1/share-links","newsletter_signup":"https://asha.news/api/v1/newsletter/subscriptions","blindspot":"https://asha.news/api/v1/blindspot","rss":"https://asha.news/rss.xml","llms":"https://asha.news/llms.txt","llms_full":"https://asha.news/llms-full.txt","sitemap":"https://asha.news/sitemap.xml","breaking":"https://asha.news/api/v1/breaking","daily_brief":"https://asha.news/api/v1/brief/daily","editorial_guidelines":"https://asha.news/.well-known/editorial-guidelines"},"editorial_guidelines":{"json":"https://asha.news/.well-known/editorial-guidelines","markdown":"https://asha.news/.well-known/editorial-guidelines.md","stance":"evidence-first, openly pro-Palestine"},"ai_author":{"key":"asha-news-ai","name":"Asha News AI Agent","type":"ai_agent","url":"https://asha.news/authors/asha-news-ai","disclosure":"This article was drafted by the Asha News AI Agent and reviewed by a human editor before publication."},"citation_policy":{"preserve_citations":true,"attribution_required":true,"url":"https://asha.news/agents/terms"},"evidence_classes":["published_sources","official_statements","verified_posts","osint_collectives","satellite_imagery","telegram_channels","leaked_documents"],"prompt":{"txt":"https://asha.news/.well-known/llm-prompt.txt","categories":["all","finance","global","local","tech","ai"]},"tools":[{"name":"get_latest_feed","endpoint":"GET https://asha.news/api/v1/feed?limit=10&timeframe=24h","skill":"use-public-news-api"},{"name":"search_asha","endpoint":"GET https://asha.news/api/v1/search?q={topic}&limit=10","skill":"use-public-news-api"},{"name":"search_articles","endpoint":"GET https://asha.news/api/v1/articles?q={topic}&limit=10","skill":"use-public-news-api"},{"name":"build_public_digest","endpoint":"GET https://asha.news/api/v1/digest?scope=public&format=markdown","skill":"use-public-news-api"},{"name":"get_share_pack","endpoint":"GET https://asha.news/api/v1/share-pack?q={topic}","skill":"use-public-news-api"},{"name":"get_story_share_pack","endpoint":"GET https://asha.news/api/v1/stories/{id}/share-pack","skill":"use-public-news-api"},{"name":"check_short_link","endpoint":"GET https://asha.news/api/v1/short-links/{key}","skill":"use-public-news-api"},{"name":"get_blindspot_feed","endpoint":"GET https://asha.news/api/v1/blindspot?topic={topic}&limit=10","skill":"use-public-news-api"},{"name":"check_public_sources","endpoint":"GET https://asha.news/api/v1/sources?limit=50","skill":"check-public-sources"},{"name":"check_source_health","endpoint":"GET https://asha.news/api/v1/sources/health?limit=50","skill":"check-public-sources"},{"name":"get_market_context","endpoint":"GET https://asha.news/api/v1/instruments/prices?symbols=BTCUSD,ETHUSD,XAUUSD,OIL","skill":"get-market-context"},{"name":"get_breaking_news","endpoint":"GET https://asha.news/api/v1/breaking","skill":"asha-news"},{"name":"get_daily_brief","endpoint":"GET https://asha.news/api/v1/brief/daily?format=markdown","skill":"asha-news"},{"name":"build_share_payload","endpoint":"GET https://asha.news/api/v1/articles/{id}/share","skill":"asha-news"},{"name":"mint_share_link","endpoint":"POST https://asha.news/api/v1/share-links {\"target_type\":\"article\",\"target_id\":\"{id}\"}","skill":"asha-news","note":"No key. Idempotent — returns the existing asha.news/s/{code} for a target."},{"name":"subscribe_newsletter","endpoint":"POST https://asha.news/api/v1/newsletter/subscriptions {\"email\":\"...\"}","skill":"asha-news","note":"Double opt-in: Asha emails a confirmation link and the subscription starts only when it is clicked. Submit only an address its owner just gave you."}],"skills":{"index":"https://asha.news/.well-known/agent-skills/index.json","wellknown_index":"https://asha.news/.well-known/skills/index.json","names":["asha-news","use-public-news-api","check-public-sources","get-market-context"],"hermes_install":"hermes skills install well-known:https://asha.news/.well-known/skills/asha-news"}}