{"service":"SmartAPIs.net","tagline":"Legally reviewed, machine-readable, coverage-visible real-world intelligence.","positioning":"Real-world intelligence for AI agents, built on legally reviewed public data and exposed through machine-readable, coverage-visible APIs.","capability_version":"v2","domains":["places","products","regulatory","transit","environment","civic"],"planned_domains":["compliance","places-v2"],"supported_queries":["find_restaurants","find_places","find_products","compare_product_offers","check_price_history","find_regulatory_records","check_license_status","review_inspection_history","plan_transit","check_environment_alerts","find_service_points","get_agent_context","list_billing_plans"],"protocols":["rest","openapi","mcp"],"auth_methods":["api_key"],"discovery_endpoints":[{"path":"/v1/agent/capabilities","method":"GET","auth":"public","description":"Public machine-readable service discovery for agents and developers."},{"path":"/v1/agent/context/{location_id}","method":"GET","auth":"public","description":"Public structured planning context for a supported launch location."},{"path":"/v1/billing/plans","method":"GET","auth":"public","description":"Public billing catalog with free and paid plans."},{"path":"/v1/openapi.yaml","method":"GET","auth":"public","description":"Public OpenAPI YAML document."},{"path":"/v1/openapi.json","method":"GET","auth":"public","description":"Public OpenAPI JSON document."},{"path":"/mcp","method":"POST","auth":"tool_specific","description":"First-party MCP endpoint for tool discovery and calls."}],"family_capabilities":[{"family":"places","description":"Search and interpret legally reviewed place records.","rest_base_path":"/v1/places","mcp_search_tool":"smartagent_places_search","mcp_detail_tool":"smartagent_place_agent_context_get","required_scopes":["places:read"],"example_recipe":"restaurant-finder-agent"},{"family":"products","description":"Search product references plus offer and price-history snapshots.","rest_base_path":"/v1/products","mcp_search_tool":"smartagent_products_search","required_scopes":["products:read"],"example_recipe":"products-watch-routes"},{"family":"regulatory","description":"Search licensing, inspection, permit, and facility records.","rest_base_path":"/v1/regulatory","mcp_search_tool":"smartagent_regulatory_licenses_search","mcp_detail_tool":"smartagent_regulatory_facility_get","required_scopes":["regulatory:read"],"example_recipe":"regulatory-watch-routes"},{"family":"transit","description":"Search route records for major transit operators.","rest_base_path":"/v1/transit","mcp_search_tool":"smartagent_transit_routes_search","required_scopes":["transit:read"],"example_recipe":"transit-assistant"},{"family":"environment","description":"Search public environment and weather-related alert references.","rest_base_path":"/v1/environment","mcp_search_tool":"smartagent_environment_alerts_search","required_scopes":["environment:read"],"example_recipe":"environment-aware-agent"},{"family":"civic","description":"Search public civic service points with privacy-reviewed contacts.","rest_base_path":"/v1/civic","mcp_search_tool":"smartagent_civic_service_points_search","required_scopes":["civic:read"],"example_recipe":"civic-lookup-agent"}],"mcp_tooling":{"endpoint_url":"/mcp","protocol_version":"2025-03-26","discovery_tools":["smartagent_discovery_capabilities","smartagent_catalog_list_plans","smartagent_context_get"],"authenticated_tip":"Provide X-API-Key or Authorization: Bearer for product and management tools; discovery tools are public."},"example_recipes":[{"slug":"restaurant-finder-agent","title":"Build a Restaurant Finder Agent in 5 Minutes","description":"Copy-paste examples using agent context, plan catalog, and places search.","languages":["curl","python","javascript"]},{"slug":"transit-assistant","title":"Build a Transit Assistant in 5 Minutes","description":"Copy-paste examples using agent context, plan catalog, and transit search.","languages":["curl","python","javascript"]},{"slug":"civic-lookup-agent","title":"Build a Civic Lookup Agent in 5 Minutes","description":"Copy-paste examples using agent context and civic service-point search.","languages":["curl","python","javascript"]},{"slug":"environment-aware-agent","title":"Build an Environment-Aware Agent in 5 Minutes","description":"Copy-paste examples using agent context and environment alerts.","languages":["curl","python","javascript"]},{"slug":"products-watch-routes","title":"Use Products Watch Routes","description":"Copy-paste examples for products search, offers, and price history.","languages":["curl","python","javascript"]},{"slug":"regulatory-watch-routes","title":"Use Regulatory Watch Routes","description":"Copy-paste examples for regulatory search, facilities, and record lookups.","languages":["curl","python","javascript"]},{"slug":"mcp-tooling","title":"Call SmartAgentAPIs Through MCP","description":"Initialize MCP, list tools, and call a product tool with an API key.","languages":["jsonrpc","curl"]}],"legal_posture":"Legality, attribution, provenance, and privacy filtering are treated as product features and release gates across Canada and the United States."}