{"openapi":"3.1.0","info":{"title":"toolgrep API","version":"0.2.0","description":"Submit and query a product directory built for AI agents. Also available as an MCP server at /mcp (see /.well-known/mcp.json)."},"servers":[{"url":"https://toolgrep.com"}],"paths":{"/api/submit":{"post":{"summary":"Submit a product URL","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string"},"email":{"type":"string"}}}}}},"responses":{"200":{"description":"Already listed"},"202":{"description":"Queued"},"422":{"description":"Invalid URL"},"429":{"description":"Rate limited"}}}},"/api/status/{id}":{"get":{"summary":"Submission status","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Status"},"404":{"description":"Unknown id"}}}},"/api/products":{"get":{"summary":"Search and filter products","description":"With q: hybrid search (full-text + semantic, any language) fused by reciprocal rank. Without q: ranking order.","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"has_free_tier","in":"query","schema":{"type":"string"}},{"name":"has_api","in":"query","schema":{"type":"string"}},{"name":"has_mcp","in":"query","schema":{"type":"string"}},{"name":"open_source","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"string"}},{"name":"offset","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Results","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"tagline":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"},"domain":{"type":"string"},"category":{"type":"string","enum":["ai-models","ai-agents","mcp-servers","api-platforms","auth","databases","hosting","devops","observability","messaging","payments","search","analytics","frontend","testing","security","dev-productivity","scraping","nocode","other"]},"tags":{"type":"array","items":{"type":"string"}},"pricing_model":{"type":"string","enum":["free","freemium","paid","usage_based","open_source","unknown"]},"price_from":{"type":"string","nullable":true},"has_free_tier":{"type":"boolean","nullable":true},"has_api":{"type":"boolean","nullable":true},"has_mcp":{"type":"boolean","nullable":true},"has_sdk":{"type":"boolean","nullable":true},"is_open_source":{"type":"boolean","nullable":true},"repo_url":{"type":"string","nullable":true},"docs_url":{"type":"string","nullable":true},"pricing_url":{"type":"string","nullable":true},"confidence":{"type":"number","nullable":true},"last_verified":{"type":"string","nullable":true},"listed_at":{"type":"string"},"source_url":{"type":"string","nullable":true}}}},"next_offset":{"type":"integer","nullable":true},"sponsored":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"tagline":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"},"domain":{"type":"string"},"category":{"type":"string","enum":["ai-models","ai-agents","mcp-servers","api-platforms","auth","databases","hosting","devops","observability","messaging","payments","search","analytics","frontend","testing","security","dev-productivity","scraping","nocode","other"]},"tags":{"type":"array","items":{"type":"string"}},"pricing_model":{"type":"string","enum":["free","freemium","paid","usage_based","open_source","unknown"]},"price_from":{"type":"string","nullable":true},"has_free_tier":{"type":"boolean","nullable":true},"has_api":{"type":"boolean","nullable":true},"has_mcp":{"type":"boolean","nullable":true},"has_sdk":{"type":"boolean","nullable":true},"is_open_source":{"type":"boolean","nullable":true},"repo_url":{"type":"string","nullable":true},"docs_url":{"type":"string","nullable":true},"pricing_url":{"type":"string","nullable":true},"confidence":{"type":"number","nullable":true},"last_verified":{"type":"string","nullable":true},"listed_at":{"type":"string"},"source_url":{"type":"string","nullable":true}}},"description":"Paid placements, always separate from items. Empty for now."}}}}}}}}},"/api/products/{slug}":{"get":{"summary":"One product","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"tagline":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"},"domain":{"type":"string"},"category":{"type":"string","enum":["ai-models","ai-agents","mcp-servers","api-platforms","auth","databases","hosting","devops","observability","messaging","payments","search","analytics","frontend","testing","security","dev-productivity","scraping","nocode","other"]},"tags":{"type":"array","items":{"type":"string"}},"pricing_model":{"type":"string","enum":["free","freemium","paid","usage_based","open_source","unknown"]},"price_from":{"type":"string","nullable":true},"has_free_tier":{"type":"boolean","nullable":true},"has_api":{"type":"boolean","nullable":true},"has_mcp":{"type":"boolean","nullable":true},"has_sdk":{"type":"boolean","nullable":true},"is_open_source":{"type":"boolean","nullable":true},"repo_url":{"type":"string","nullable":true},"docs_url":{"type":"string","nullable":true},"pricing_url":{"type":"string","nullable":true},"confidence":{"type":"number","nullable":true},"last_verified":{"type":"string","nullable":true},"listed_at":{"type":"string"},"source_url":{"type":"string","nullable":true}}}}}},"404":{"description":"Not found"}}}}}}