{"_id":"@apitomy/data-models-mcp","name":"@apitomy/data-models-mcp","dist-tags":{"latest":"1.2.0"},"versions":{"1.2.0":{"name":"@apitomy/data-models-mcp","version":"1.2.0","description":"MCP server wrapping @apitomy/data-models for AI-assisted OpenAPI and AsyncAPI editing","type":"module","main":"dist/index.js","bin":{"apitomy-data-models-mcp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","test":"vitest run","test:watch":"vitest","lint":"biome check src test","lint:fix":"biome check --fix src test"},"keywords":["mcp","openapi","asyncapi","apitomy","data-models"],"license":"Apache-2.0","dependencies":{"@apitomy/data-models":"3.1.0","@modelcontextprotocol/sdk":"1.27.1","js-yaml":"4.1.1","zod":"4.3.6"},"devDependencies":{"@biomejs/biome":"2.4.6","@types/js-yaml":"4.0.9","@types/node":"22.19.15","typescript":"5.9.3","vitest":"4.0.18"},"_id":"@apitomy/data-models-mcp@1.2.0","gitHead":"bc5346af537e9db6cfc51c9033d18126864d6408","types":"./dist/index.d.ts","_nodeVersion":"22.17.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-utovtBEJUaqE5PpvnZX6qL429GMuHF7FhP5caPhkuJ85BOj9gtcY6D/xx5G+8/Iiy+CT8IZMJOSQn/VT5h2mjg==","shasum":"4bc47ea7a8af9508e6a5f5c72f152a142391d60a","tarball":"https://registry.npmjs.org/@apitomy/data-models-mcp/-/data-models-mcp-1.2.0.tgz","fileCount":95,"unpackedSize":389532,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDoyAyOkVNwPxIa8+eNQuj+I4e96Eb3yHZe7fTESthnuAIhAMJUo2OeY75tJzpaFlP5DuQ7iOTsxhvRyHjqfifZY8TF"}]},"_npmUser":{"name":"apitomy.ci","email":"apitomy.ci@gmail.com"},"directories":{},"maintainers":[{"name":"apitomy.ci","email":"apitomy.ci@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/data-models-mcp_1.2.0_1779491416028_0.6826484256728047"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-22T23:10:15.847Z","1.2.0":"2026-05-22T23:10:16.197Z","modified":"2026-05-22T23:10:16.356Z"},"maintainers":[{"name":"apitomy.ci","email":"apitomy.ci@gmail.com"}],"description":"MCP server wrapping @apitomy/data-models for AI-assisted OpenAPI and AsyncAPI editing","keywords":["mcp","openapi","asyncapi","apitomy","data-models"],"license":"Apache-2.0","readme":"# apitomy-data-models-mcp\n\nAn MCP (Model Context Protocol) server that wraps the `@apitomy/data-models` library, making it\neasy for AI coding agents to query, validate, and edit OpenAPI and AsyncAPI documents.\n\n## Supported Specifications\n\n- OpenAPI 2.0 (Swagger)\n- OpenAPI 3.0.x\n- AsyncAPI 2.x\n- AsyncAPI 3.x\n\n## Quick Start\n\n### Install from npm\n\n```bash\nnpm install -g @apitomy/data-models-mcp\n```\n\n### Configure in Claude Code\n\nThe easiest way is to use the `claude mcp add` command:\n\n```bash\nclaude mcp add apitomy-data-models apitomy-data-models-mcp\n```\n\n## Tool Catalog\n\nThe server provides **102 tools** across 5 categories: session management (7), document\nquerying (16), document editing (76), validation (1), and transformation (2).\n\nSee the [full tools reference](docs/Tools.md) for detailed documentation on every tool and\nits parameters.\n\n## MCP Resources\n\n| URI Pattern | Description |\n|-------------|-------------|\n| `api://{session}/info` | Document metadata |\n| `api://{session}/paths` | List of paths/channels |\n| `api://{session}/schemas` | List of schema definitions |\n\n## Usage Examples\n\n### Load and inspect an existing API\n\n```\n> Load /path/to/petstore.yaml into session \"petstore\"\n> What paths does the petstore API have?\n> Show me the GET /pets operation\n> Validate the document\n```\n\n### Create a new API from scratch\n\n```\n> Create a new OpenAPI 3.0 document called \"widgets\"\n> Set the title to \"Widget API\" and version to \"1.0.0\"\n> Add a path /widgets with GET and POST operations\n> Add a Widget schema with id, name, and color properties\n> Save it to ./widget-api.yaml as YAML\n```\n\n### Transform a Swagger document\n\n```\n> Load my swagger.json as \"legacy\"\n> Transform it to OpenAPI 3.0\n> Validate the transformed document\n> Save it to openapi3.json\n```\n\n## Development\n\n```bash\nnpm install          # Install dependencies\nnpm run build        # Compile TypeScript\nnpm test             # Run tests\nnpm run test:watch   # Run tests in watch mode\n```\n","readmeFilename":"README.md","_rev":"1-d9476c884cad81db22f6743eb06d1f0b"}