{"openapi":"3.1.0","info":{"title":"4agent Public API","version":"1.0.0","description":"Discover agent-ready tools and retrieve executable agent recipes. The public API is read-only and does not require authentication."},"servers":[{"url":"https://4agent.dev"}],"security":[],"paths":{"/api/tools":{"get":{"operationId":"listOrGetTools","summary":"List, search, filter, or retrieve tools","description":"Returns published tool records. Pass id for one exact tool, q for full-text search, category for filtering, or view=summary for a smaller payload.","parameters":[{"name":"id","in":"query","description":"Exact tool identifier.","schema":{"type":"string"}},{"name":"q","in":"query","description":"Full-text search query.","schema":{"type":"string"}},{"name":"category","in":"query","description":"Category slug to filter by.","schema":{"type":"string"}},{"name":"view","in":"query","description":"Use summary for card-ready fields.","schema":{"type":"string","enum":["summary"]}}],"responses":{"200":{"description":"A single tool or a tool collection.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["tool"],"properties":{"tool":{"type":"object","required":["id","name","tagline","category","description","url","auth_method","pricing","integration","tags","verified"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"tagline":{"type":"string"},"category":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"api_endpoint":{"type":"string"},"auth_method":{"type":"string"},"pricing":{"type":"object","required":["model","free_tier","starting_price"],"properties":{"model":{"type":"string"},"free_tier":{"type":"boolean"},"starting_price":{"type":"string"}}},"integration":{"type":"object","required":["mcp","cli","openapi","sdk"],"properties":{"mcp":{"type":"boolean"},"cli":{"type":"boolean"},"openapi":{"type":"boolean"},"sdk":{"type":"array","items":{"type":"string"}}}},"tags":{"type":"array","items":{"type":"string"}},"submitted_at":{"type":"string","format":"date"},"verified":{"type":"boolean"}}}}},{"type":"object","required":["count","tools"],"properties":{"count":{"type":"integer"},"tools":{"type":"array","items":{"type":"object","required":["id","name","tagline","category","description","url","auth_method","pricing","integration","tags","verified"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"tagline":{"type":"string"},"category":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"api_endpoint":{"type":"string"},"auth_method":{"type":"string"},"pricing":{"type":"object","required":["model","free_tier","starting_price"],"properties":{"model":{"type":"string"},"free_tier":{"type":"boolean"},"starting_price":{"type":"string"}}},"integration":{"type":"object","required":["mcp","cli","openapi","sdk"],"properties":{"mcp":{"type":"boolean"},"cli":{"type":"boolean"},"openapi":{"type":"boolean"},"sdk":{"type":"array","items":{"type":"string"}}}},"tags":{"type":"array","items":{"type":"string"}},"submitted_at":{"type":"string","format":"date"},"verified":{"type":"boolean"}}}}}}]}}}},"404":{"description":"The requested tool does not exist.","content":{"application/json":{"schema":{"type":"object","required":["error","code","resolution"],"properties":{"error":{"type":"string","description":"Human-readable error message."},"code":{"type":"string","description":"Stable machine-readable error code."},"resolution":{"type":"string","description":"Action that can resolve the error."}}}}}}}}},"/api/recipes/{slug}":{"get":{"operationId":"getRecipe","summary":"Retrieve an executable agent recipe","description":"Returns an ordered task plan with capabilities, recommended tools, alternatives, typed inputs and outputs, and fallback behavior.","parameters":[{"name":"slug","in":"path","required":true,"description":"Recipe slug.","schema":{"type":"string"}}],"responses":{"200":{"description":"The serialized recipe.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"The requested recipe does not exist.","content":{"application/json":{"schema":{"type":"object","required":["error","code","resolution"],"properties":{"error":{"type":"string","description":"Human-readable error message."},"code":{"type":"string","description":"Stable machine-readable error code."},"resolution":{"type":"string","description":"Action that can resolve the error."}}}}}}}}}}}