An MCP (Model Context Protocol) server that wraps the @apitomy/data-models library, making it
easy for AI coding agents to query, validate, and edit OpenAPI and AsyncAPI documents.
- OpenAPI 2.0 (Swagger)
- OpenAPI 3.0.x
- OpenAPI 3.1.x
- AsyncAPI 2.x
- AsyncAPI 3.x
npm install -g @apitomy/data-models-mcpThe easiest way is to use the claude mcp add command:
claude mcp add apitomy-data-models apitomy-data-models-mcpThe server provides 102 tools across 5 categories: session management (7), document querying (16), document editing (76), validation (1), and transformation (2).
See the full tools reference for detailed documentation on every tool and its parameters.
| URI Pattern | Description |
|---|---|
api://{session}/info |
Document metadata |
api://{session}/paths |
List of paths/channels |
api://{session}/schemas |
List of schema definitions |
> Load /path/to/petstore.yaml into session "petstore"
> What paths does the petstore API have?
> Show me the GET /pets operation
> Validate the document
> Create a new OpenAPI 3.0 document called "widgets"
> Set the title to "Widget API" and version to "1.0.0"
> Add a path /widgets with GET and POST operations
> Add a Widget schema with id, name, and color properties
> Save it to ./widget-api.yaml as YAML
> Load my swagger.json as "legacy"
> Transform it to OpenAPI 3.0
> Validate the transformed document
> Save it to openapi3.json
npm install # Install dependencies
npm run build # Compile TypeScript
npm test # Run tests
npm run test:watch # Run tests in watch mode
npm run lint # Run linterSee CONTRIBUTING.md for guidelines on how to contribute to this project.
This project is licensed under the Apache License 2.0.