{"name":"BrokerMafia","product":"BrokerMafia","description":"Public agent-ready directory of brokers (FMCSA, SEC, TDI, TREC, and more). Indexed point lookups and capped search only.","baseUrl":"https://brokermafia.com/api/v1","homepage":"https://brokermafia.com/","humanDocs":"https://brokermafia.com/agents/","openapi":"https://brokermafia.com/api/v1/openapi.json","mcp":{"stdio":{"packagePath":"https://brokermafia.com/agents/#mcp","install":"See /workspace/brokermafia/mcp or clone repo mcp/ folder","tools":["search_brokers","get_broker","lookup_fmcsa_mc","lookup_fmcsa_usdot","list_verticals","get_stats"]},"remote":"Not hosted yet — use stdio MCP proxying this HTTPS API."},"tools":[{"name":"search_brokers","method":"GET","path":"/search","params":["q","vertical","state","source","limit"],"limitDefault":20,"limitMax":50},{"name":"get_broker","method":"GET","path":"/brokers/{slug}"},{"name":"lookup_fmcsa_mc","method":"GET","path":"/fmcsa/mc/{mc}"},{"name":"lookup_fmcsa_usdot","method":"GET","path":"/fmcsa/usdot/{dot}"},{"name":"list_verticals","method":"GET","path":"/verticals"},{"name":"get_stats","method":"GET","path":"/stats"},{"name":"health","method":"GET","path":"/health"}],"rate":{"guidance":"Be polite: prefer cached stats/verticals; batch point lookups; keep search limit ≤20 unless needed.","cache":"stats/verticals long TTL; search short TTL; broker/MC medium TTL"},"cautions":["NO live COUNT(*) or heavy aggregates on request paths.","Stats come from offline brokermafia.stats / ASSETS /data/stats.json only.","Search is capped (max 50). Unfiltered search is rejected.","Public regulatory names/IDs only — not an FMCSA endorsement.","Never send Supabase service_role keys to clients."],"urlPolicy":{"firmProfiles":"https://brokermafia.com/brokers/{slug}/","fmcsaAuthoritySuffixes":["-mc{docket}","-ff{docket}","-mx{docket}","-usdot-{dot}"],"forbidden":["UUID/hash paths","fake ratings","implying regulator endorsement"]},"cors":"*","auth":"none (public read)"}