{"contract_version":"bda-mcp-public-tool-catalog-v1","mcp_status":"public-tool-catalog","transport":{"json_rpc":"/mcp","methods":["initialize","tools/list","tools/call","resources/list","resources/read"],"protocol_note":"First public read-only MCP transport slice; streamable/SSE transports remain future work."},"note":"This endpoint exposes the public read-only tool catalog for MCP/A2A clients. Private user tools must use authenticated service contracts.","public_tools":[{"name":"get_today_panchang","description":"Return public daily Panchang data for a city/date context.","method":"GET","endpoint":"/panchang/daily","auth":"none","safe_for_public_agents":true},{"name":"get_panchang_by_date_city","description":"Return public Panchang JSON for a supplied date and city/location.","method":"GET","endpoint":"/panchang/daily","auth":"none","safe_for_public_agents":true},{"name":"get_festival_calendar","description":"Return public festival feed or calendar export.","method":"GET","endpoint":"/feeds/festivals.json","auth":"none","safe_for_public_agents":true},{"name":"get_udaya_lagna","description":"Return certified public ascendant-sign windows from local sunrise to the next local sunrise.","method":"GET","endpoint":"/lagna/table","auth":"none","safe_for_public_agents":true},{"name":"get_tithi_info","description":"Use the public Panchang utility/evidence endpoints for tithi context.","method":"GET","endpoint":"/panchang/utility","auth":"none","safe_for_public_agents":true},{"name":"get_tithi_calendar","description":"Return deterministic annual start/end spans for one Tithi in the requested location timezone.","method":"GET","endpoint":"/panchang/tithi/{slug}","auth":"none","safe_for_public_agents":true},{"name":"get_nakshatra_info","description":"Use public Panchang endpoints for nakshatra context by date/location.","method":"GET","endpoint":"/panchang/daily","auth":"none","safe_for_public_agents":true},{"name":"get_kundali_explanation","description":"Return public Jyotish concept explanations without generating private user Kundali data.","method":"GET","endpoint":"/jyotish/concepts/{slug}","auth":"none","safe_for_public_agents":true},{"name":"search_sanatan_encyclopedia","description":"Use canonical public Sanatan Encyclopedia pages and future search contracts.","method":"GET","endpoint":"https://www.bda.ai/sanatan-encyclopedia","auth":"none","safe_for_public_agents":true},{"name":"get_mantra_meaning","description":"Return public reviewed-source discovery guidance for mantra meanings.","method":"GET","endpoint":"https://www.bda.ai/sanatan-encyclopedia","auth":"none","safe_for_public_agents":true},{"name":"get_jyotish_glossary_term","description":"Return public Jyotish glossary/concept explanation metadata.","method":"GET","endpoint":"/jyotish/concepts/{slug}","auth":"none","safe_for_public_agents":true},{"name":"get_public_bda_feature_summary","description":"Return public BDA service and API discovery metadata.","method":"GET","endpoint":"/ai-sitemap.json","auth":"none","safe_for_public_agents":true},{"name":"list_public_sitemap_urls","description":"Return a paged public URL catalog from BDA sitemaps so agents can discover the full public site without crawling private surfaces.","method":"GET","endpoint":"/sitemap.xml and https://www.bda.ai public sitemap functions","auth":"none","safe_for_public_agents":true},{"name":"get_public_page_metadata","description":"Fetch safe public BDA page metadata for a single allowlisted public URL without returning page body content.","method":"GET","endpoint":"https://www.bda.ai/{public-path}","auth":"none","safe_for_public_agents":true},{"name":"list_public_api_endpoints","description":"List public evaluation endpoints from the filtered public OpenAPI contract, excluding identity, donation, memory, client-log, external-database, alerting, rendered-page, and internal routes.","method":"GET","endpoint":"/docs/api and /openapi.json","recommended_endpoint":"/api-docs and /api-docs/openapi.json","auth":"none","safe_for_public_agents":true}],"private_tools_reserved":["generate_user_kundali","get_user_dashboard_summary","get_user_saved_reports","update_birth_details"],"private_tool_policy":"Do not expose private user data through public MCP tools."}