MCP-OpenAPI

{"openapi":"3.1.0","info":{"title":"Todo API","description":"A simple API for managing a todo list","version":"1.0.0"},"servers":[{"url":"http://localhost:8000","description":"Local server"}],"paths":{"/todos/all":{"get":{"tags":["todos"],"summary":"Get all todos","description":"Get all todos, including completed ones","operationId":"get_all_todos_todos_all_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Todo"},"type":"array","title":"Response Get All Todos Todos All Get"}}}}}}},"/todos":{"post":{"tags":["todos"],"summary":"Create a todo","description":"Add an item to the todo list","operationId":"create_todo_todos_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Todo"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Todo"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/todos/completed":{"get":{"tags":["todos"],"summary":"Get all completed todos","description":"Get all todos that are completed","operationId":"get_completed_todos_todos_completed_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Todo"},"type":"array","title":"Response Get Completed Todos Todos Completed Get"}}}}}}},"/todos/tags/{tag}":{"get":{"tags":["todos"],"summary":"Get all todos with a given tag","description":"Get all todos that have the given tag","operationId":"get_todos_with_tag_todos_tags__tag__get","parameters":[{"name":"tag","in":"path","required":true,"schema":{"type":"string","title":"Tag"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Todo"},"title":"Response Get Todos With Tag Todos Tags Tag Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/todos/{todo_id}":{"put":{"tags":["todos"],"summary":"Update a todo","description":"Update a todo with the given id","operationId":"update_todo_todos__todo_id__put","parameters":[{"name":"todo_id","in":"path","required":true,"schema":{"type":"integer","title":"Todo Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Todo"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Todo"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["todos"],"summary":"Delete a todo","description":"Delete a todo with the given id","operationId":"delete_todo_todos__todo_id__delete","parameters":[{"name":"todo_id","in":"path","required":true,"schema":{"type":"integer","title":"Todo Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Todo"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/todos/tags":{"get":{"tags":["todos"],"summary":"Get all tags","description":"Get all tags","operationId":"get_all_tags_todos_tags_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array","title":"Response Get All Tags Todos Tags Get"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Todo":{"properties":{"id":{"type":"integer","title":"Id"},"title":{"type":"string","title":"Title"},"completed":{"type":"boolean","title":"Completed"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"}},"type":"object","required":["title","completed"],"title":"Todo"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}