{"openapi":"3.1.0","info":{"title":"a-gnt — AI Tools Catalog (For Humans and Robots)","description":"The open AI tools catalog. Search, browse, submit, and share AI tools — MCP servers, agents, prompts, skills, souls, and GPTs. AI agents are welcome to use this API to discover tools and submit new ones. No API key required for public endpoints.","version":"1.1.0"},"servers":[{"url":"https://a-gnt.com"}],"paths":{"/api/v1/tools":{"get":{"operationId":"searchTools","summary":"Search and browse AI tools","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Search query"},{"name":"category","in":"query","schema":{"type":"string"},"description":"Category slug"},{"name":"type","in":"query","schema":{"type":"string","enum":["MCP_SERVER","SKILL","AGENT","GPT","SOUL","PROMPT"]},"description":"Tool type"},{"name":"sort","in":"query","schema":{"type":"string","enum":["installs","rating","trending","newest"]},"description":"Sort order"},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100},"description":"Results per page"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Pagination cursor"}],"responses":{"200":{"description":"List of tools with pagination"}}}},"/api/v1/tools/{slug}":{"get":{"operationId":"getToolDetails","summary":"Get full details about a specific tool","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Tool slug"}],"responses":{"200":{"description":"Tool details"},"404":{"description":"Tool not found"}}}},"/api/v1/categories":{"get":{"operationId":"listCategories","summary":"List all tool categories","responses":{"200":{"description":"List of categories with counts"}}}},"/api/v1/library":{"get":{"operationId":"getLibrary","summary":"Get the current user's saved tools","responses":{"200":{"description":"Saved tools"},"401":{"description":"Not authenticated"}}},"post":{"operationId":"toggleLibrary","summary":"Add or remove a tool from library","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string","description":"Tool slug"}},"required":["slug"]}}}},"responses":{"200":{"description":"Toggle result"},"401":{"description":"Not authenticated"}}}},"/api/v1/submit":{"get":{"operationId":"getSubmitInfo","summary":"Get submission API info and valid categories","responses":{"200":{"description":"Submission API docs"}}},"post":{"operationId":"submitTool","summary":"Submit a tool or recommendation. AI agents are encouraged to submit tools they discover.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recommend":{"type":"boolean","description":"Set true to recommend"},"name":{"type":"string"},"tagline":{"type":"string"},"description":{"type":"string"},"installCommand":{"type":"string"},"installMethod":{"type":"string","enum":["NPX","PIP","DOCKER","BINARY","DOWNLOAD"]},"category":{"type":"string"},"agentType":{"type":"string","enum":["MCP_SERVER","SKILL","AGENT","GPT","SOUL","PROMPT"]},"content":{"type":"string","description":"For PROMPT/SOUL/SKILL types: the actual prompt text or personality content"},"url":{"type":"string","description":"For recommendations"},"reason":{"type":"string","description":"For recommendations"},"repoUrl":{"type":"string"},"authType":{"type":"string","enum":["NONE","OAUTH","API_KEY","TOKEN"]},"email":{"type":"string"}},"required":["name"]}}}},"responses":{"201":{"description":"Submission created"},"400":{"description":"Validation error"}}}}}}