YaSwag

What it does

YaSwag is a comprehensive tool for Go developers to generate OpenAPI 3.x specifications from source code using custom annotations. Beyond generation, it provides an MCP server that allows AI assistants to interact with API specifications via semantic search and schema exploration, effectively turning your API docs into an interactive knowledge base for AI.

Tools

• search_endpoints: Search for API endpoints using natural language.
• list_endpoints: List all available endpoints with optional filtering.
• get_endpoint: Retrieve detailed information about a specific endpoint.
• search_schemas: Search through schema definitions.
• get_schema: Get a detailed view of a specific schema definition.
• validate_spec: Validate the current OpenAPI specification.
• get_spec_info: Get general information about the API specification.
• generate_example: Create example request and response data.
• find_related: Discover endpoints related to the current one.
• list_tags: List all API tags and their endpoint counts.
• analyze_security: Perform a security analysis of the API requirements.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "yaswag": {
      "command": "yaswag",
      "args": ["mcp", "./openapi.json"]
    }
  }
}

Supported hosts

• Claude