Apitomy Data Models MCP
OfficialProvides tools to load, query, validate, edit, and transform Swagger/OpenAPI documents (OpenAPI 2.0, 3.0.x, 3.1.x) as well as AsyncAPI documents.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Apitomy Data Models MCP Load petstore.yaml and list all paths."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Apitomy Data Models MCP
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.
Supported Specifications
OpenAPI 2.0 (Swagger)
OpenAPI 3.0.x
OpenAPI 3.1.x
AsyncAPI 2.x
AsyncAPI 3.x
Related MCP server: mcp-openapi-schema
Quick Start
Install from npm
npm install -g @apitomy/data-models-mcpConfigure in Claude Code
The easiest way is to use the claude mcp add command:
claude mcp add apitomy-data-models apitomy-data-models-mcpTool Catalog
The 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.
MCP Resources
URI Pattern | Description |
| Document metadata |
| List of paths/channels |
| List of schema definitions |
Usage Examples
Load and inspect an existing API
> Load /path/to/petstore.yaml into session "petstore"
> What paths does the petstore API have?
> Show me the GET /pets operation
> Validate the documentCreate a new API from scratch
> 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 YAMLTransform a Swagger document
> Load my swagger.json as "legacy"
> Transform it to OpenAPI 3.0
> Validate the transformed document
> Save it to openapi3.jsonDevelopment
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 linterLinks
Contributing
See CONTRIBUTING.md for guidelines on how to contribute to this project.
License
This project is licensed under the Apache License 2.0.
Available Tools
102 toolsdocument_add_callbackA
Add a callback definition to an operation or to components (OpenAPI 3.x only)
Inputs: name (required), session (required), nodePath (required), callback.
document_add_channelC
Add a channel item to an AsyncAPI document
Inputs: channel (required), session (required), channelItem.
document_add_exampleB
Add a named example to a media type, parameter, or header (OpenAPI 3.x)
Inputs: name (required), value (required), session (required), nodePath (required), +2 more.
document_add_example_definitionC
Add a reusable example definition to the document components (OpenAPI 3.x only)
Inputs: name (required), example (required), session (required).
document_add_extensionB
Add a vendor extension (x-* property) to any node in the document
Inputs: name (required), value (required), session (required), nodePath (required).
document_add_header_definitionA
Add a reusable header definition to the document components (OpenAPI 3.x only)
Inputs: name (required), header (required), session (required).
document_add_linkC
Add a link to a response or to components (OpenAPI 3.x only)
Inputs: link (required), name (required), session (required), nodePath (required).
document_add_media_typeB
Add a media type to a request body or response (OpenAPI 3.x)
Inputs: session (required), nodePath (required), mediaType (required).
document_add_operationC
Add a new HTTP operation to an existing path item
Inputs: path (required), method (required), session (required).
document_add_parameterC
Add a parameter to a path item or operation
Inputs: name (required), path (required), session (required), location (required), +4 more.
document_add_parameter_definitionC
Add a reusable parameter definition to the document components
Inputs: name (required), session (required), parameter (required).
document_add_pathC
Add a new path item to an OpenAPI document
Inputs: path (required), session (required), pathItem.
document_add_request_bodyB
Add an empty request body to an operation (OpenAPI 3.x only)
Inputs: path (required), method (required), session (required).
document_add_request_body_definitionA
Add a reusable request body definition to the document components (OpenAPI 3.x only)
Inputs: name (required), session (required), requestBody (required).
document_add_responseC
Add a response to an operation by status code and description
Inputs: path (required), method (required), session (required), statusCode (required), +1 more.
document_add_response_definitionB
Add a reusable response definition to the document
Inputs: name (required), session (required), response (required).
document_add_response_headerC
Add a header to an OpenAPI response
Inputs: name (required), session (required), nodePath (required), schemaRef, +2 more.
document_add_schemaB
Add a schema definition to the document
Inputs: name (required), schema (required), session (required).
document_add_schema_enumC
Set enum values on a schema
Inputs: values (required), session (required), nodePath (required).
document_add_schema_propertyC
Add a named property to an object schema definition
Inputs: schema (required), session (required), schemaName (required), propertyName (required).
document_add_security_requirementC
Add a security requirement to the document or to a specific operation
Inputs: session (required), requirement (required), path, method.
document_add_security_schemeC
Add a security scheme definition to the document
Inputs: name (required), scheme (required), session (required).
document_add_serverA
Add a server to the document or to a specific path/operation
Inputs: url (required), session (required), nodePath, description.
document_add_server_variableA
Add a variable to a server definition (OpenAPI 3.x only)
Inputs: name (required), default (required), session (required), nodePath (required), +2 more.
document_add_tagB
Add a tag definition to the document
Inputs: name (required), session (required), description.
document_clone_sessionA
Clone an existing session into a new session with a deep copy of the document
Inputs: session (required), newSession (required).
document_closeA
Close a named session and release the document from memory
Inputs: session (required).
document_copy_operationB
Copy an operation from one path/method to another
Inputs: session (required), sourcePath (required), targetPath (required), sourceMethod (required), +1 more.
document_createA
Create a new empty OpenAPI or AsyncAPI document in a named session
Inputs: session (required), modelType (required), title, version.
document_delete_contactB
Remove the contact object from the document info
Inputs: session (required).
document_delete_licenseA
Remove the license object from the document info
Inputs: session (required).
document_dereferenceA
Resolve all $ref references in the document, pulling external references inline
Inputs: session (required).
document_exportA
Export the document content as a JSON or YAML string
Inputs: session (required), format.
document_find_refsA
Find all $ref references to a given definition throughout the document
Inputs: ref (required), session (required).
document_get_infoA
Get document overview: type, title, version, path/schema counts
Inputs: session (required).
document_get_nodeA
Get any node by its node path (e.g. /paths[/pets]/get, /info, /components/schemas[Pet])
Inputs: session (required), nodePath (required).
document_get_operationA
Get full details of a specific operation by path and HTTP method
Inputs: path (required), session (required), method.
document_get_schemaA
Get a specific schema definition by name with its full content
Inputs: name (required), session (required).
document_list_examplesC
List examples on a media type, parameter, or header
Inputs: session (required), nodePath (required).
document_list_extensionsA
List all vendor extensions (x-* properties) on a specific node
Inputs: session (required), nodePath (required).
document_list_media_typesC
List media types on a request body or response
Inputs: session (required), nodePath (required).
document_list_operationsB
List all operations across the entire document with path, method, operationId, summary, and tags
Inputs: session (required).
document_list_parametersB
List parameters on a specific path item or operation
Inputs: path (required), session (required), method.
document_list_pathsA
List all paths (OpenAPI) or channels (AsyncAPI) with their operations
Inputs: session (required).
document_list_responsesB
List responses on a specific operation with status codes and descriptions
Inputs: path (required), method (required), session (required).
document_list_schemasC
List all schema/component definitions in the document
Inputs: session (required).
document_list_security_schemesA
List all security scheme definitions in the document
Inputs: session (required).
document_list_serversA
List all server definitions in the document
Inputs: session (required).
document_list_sessionsA
List all active document sessions
Inputs: no named parameters.
document_list_tagsA
List all tag definitions in the document
Inputs: session (required).
document_loadB
Load an OpenAPI or AsyncAPI file into a named session
Inputs: session (required), filePath (required), format.
document_move_operationB
Move an operation from one path/method to another
Inputs: session (required), sourcePath (required), targetPath (required), sourceMethod (required), +1 more.
document_remove_all_examplesB
Remove all examples from a media type, parameter, or header
Inputs: session (required), nodePath (required).
document_remove_all_extensionsB
Remove all vendor extensions from a node
Inputs: session (required), nodePath (required).
document_remove_all_operationsB
Remove all operations from a path item
Inputs: path (required), session (required).
document_remove_all_parametersA
Remove all parameters (or parameters of a specific type) from a path item or operation
Inputs: path (required), session (required), type, method.
document_remove_all_response_headersB
Remove all headers from a response
Inputs: session (required), nodePath (required).
document_remove_all_responsesB
Remove all responses from an operation
Inputs: path (required), method (required), session (required).
document_remove_all_schema_propertiesB
Remove all properties from a schema
Inputs: session (required), schemaName (required).
document_remove_all_security_requirementsA
Remove all security requirements from the document or from a specific operation
Inputs: session (required), path, method.
document_remove_all_security_schemesB
Remove all security scheme definitions from the document
Inputs: session (required).
document_remove_all_serversB
Remove all servers from the document, a path item, or an operation
Inputs: session (required), nodePath.
document_remove_all_tagsB
Remove all tag definitions from the document
Inputs: session (required).
document_remove_callbackB
Remove a callback from an operation or components (OpenAPI 3.x only)
Inputs: name (required), session (required), nodePath (required).
document_remove_example_definitionB
Remove a reusable example definition from the document components (OpenAPI 3.x only)
Inputs: name (required), session (required).
document_remove_extensionB
Remove a vendor extension (x-* property) from a node
Inputs: name (required), session (required), nodePath (required).
document_remove_header_definitionB
Remove a reusable header definition from the document components (OpenAPI 3.x only)
Inputs: name (required), session (required).
document_remove_linkB
Remove a link from a response or components (OpenAPI 3.x only)
Inputs: name (required), session (required), nodePath (required).
document_remove_media_typeA
Remove a specific media type from a request body or response
Inputs: session (required), nodePath (required).
document_remove_nodeA
Remove any node at a given node path
Inputs: session (required), nodePath (required).
document_remove_operationB
Remove a specific HTTP operation from a path item
Inputs: path (required), method (required), session (required).
document_remove_parameterB
Remove a parameter from a path item or operation
Inputs: name (required), path (required), session (required), location (required), +1 more.
document_remove_parameter_definitionB
Remove a reusable parameter definition from the document components
Inputs: name (required), session (required).
document_remove_pathB
Remove a path item from the document
Inputs: path (required), session (required).
document_remove_request_bodyB
Remove the request body from an operation (OpenAPI 3.x only)
Inputs: path (required), method (required), session (required).
document_remove_request_body_definitionA
Remove a reusable request body definition from the document components (OpenAPI 3.x only)
Inputs: name (required), session (required).
document_remove_responseC
Remove a response from an operation by status code
Inputs: path (required), method (required), session (required), statusCode (required).
document_remove_response_headerB
Remove a header from an OpenAPI response
Inputs: name (required), session (required), nodePath (required).
document_remove_schemaB
Remove a schema definition from the document
Inputs: name (required), session (required).
document_remove_schema_propertyB
Remove a named property from an object schema definition
Inputs: session (required), schemaName (required), propertyName (required).
document_remove_security_schemeC
Remove a security scheme definition from the document
Inputs: name (required), session (required).
document_remove_serverB
Remove a server from the document or a specific scope
Inputs: url (required), session (required), nodePath.
document_remove_server_variableB
Remove a variable from a server definition (OpenAPI 3.x only)
Inputs: name (required), session (required), nodePath (required).
document_remove_tagC
Remove a tag definition from the document
Inputs: name (required), session (required).
document_rename_pathA
Rename a path, preserving all operations and configuration
Inputs: newPath (required), oldPath (required), session (required).
document_rename_schemaB
Rename a schema definition and update all $ref references throughout the document
Inputs: newName (required), oldName (required), session (required).
document_rename_tagA
Rename a tag across the entire document (updates both the tag definition and all operation references)
Inputs: newName (required), oldName (required), session (required).
document_saveB
Save the document from a session to a file
Inputs: session (required), format, filePath.
document_set_contactB
Set the contact information in the document info
Inputs: session (required), url, name, email.
document_set_external_docsB
Set external documentation on a node (document, tag, operation, or schema)
Inputs: url (required), session (required), nodePath, description.
document_set_infoB
Set document title, description, and/or version
Inputs: session (required), title, version, description.
document_set_licenseC
Set the license information in the document info
Inputs: name (required), session (required), url.
document_set_media_type_schemaC
Set the schema for a media type, either as a $ref or inline type
Inputs: session (required), nodePath (required), schemaRef, schemaType.
document_set_nodeB
Set or replace any node at a given node path using in-place update
Inputs: value (required), session (required), nodePath (required).
document_set_operation_infoC
Set metadata properties on an operation (operationId, summary, description, deprecated)
Inputs: path (required), method (required), session (required), summary, +3 more.
document_set_operation_tagsC
Set the tags array on an operation
Inputs: path (required), tags (required), method (required), session (required).
document_set_schema_requiredB
Set the required array on a schema, controlling which properties are mandatory
Inputs: session (required), required (required), schemaName (required).
document_set_schema_typeB
Set the type field on a schema (string, object, array, integer, number, boolean)
Inputs: type (required), session (required), nodePath (required).
document_transformC
Convert an OpenAPI document between spec versions (e.g. OpenAPI 2.0 -> 3.0, 3.0 -> 3.1)
Inputs: session (required), targetType (required).
document_update_extensionB
Update the value of an existing vendor extension
Inputs: name (required), value (required), session (required), nodePath (required).
document_update_security_schemeB
Update an existing security scheme definition
Inputs: name (required), scheme (required), session (required).
document_validateB
Validate the document and return structured validation problems
Inputs: session (required), nodePath.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 102 tools
Most tools target distinct resources and actions, but the enormous number combined with overlapping verbs (add/set/update/remove/delete) creates real ambiguity. Generic tools like document_set_node and document_get_node blur boundaries with their specific counterparts, and delete/remove pairs like document_delete_license vs document_remove_tag are easy to conflate.
All tools share a consistent document_ prefix and snake_case format, which helps navigation. However, verb usage is inconsistent: delete vs remove, set vs update, and add vs create are used interchangeably for similar mutation operations, making the pattern less predictable than it could be.
With 102 tools, the server far exceeds the 'too many' threshold and imposes a heavy selection burden on agents. Even for a comprehensive OpenAPI/AsyncAPI editor, this surface should be consolidated into fewer, more parameterized operations.
The OpenAPI side is exceptionally complete, covering paths, operations, schemas, responses, parameters, security, extensions, and lifecycle operations. However, AsyncAPI support has notable gaps such as no remove_channel or update_channel tool, and individual security requirement removal is missing.
Maintenance
Related MCP Connectors
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
MCP server for the Seline Analytics API
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Ovanek MCP: Model Context Protocol server for Ovanek platform tools; writes are dry-run by default.
Related MCP Servers
- AlicenseBqualityNot gradedmaintenanceA Model Context Protocol (MCP) server that provides JSON-RPC functionality through OpenRPC.242Apache 2.0
- AlicenseNot gradedqualityDmaintenanceA MCP server that exposes OpenAPI schema information to LLMs like Claude. This server allows an LLM to explore and understand large OpenAPI schemas through a set of specialized tools, without needing to load the whole schema into the context50MIT
- AlicenseNot gradedqualityBmaintenanceMCP server providing token-efficient access to OpenAPI/Swagger specs via MCP Resources for client-side exploration.582 npm76MIT
- FlicenseNot gradedqualityDmaintenanceA server implementation of the Model Context Protocol (MCP) that provides REST API endpoints for managing and interacting with MCP resources.-