Skip to main content
Glama
Apitomy Data Models MCP

Apitomy Data Models MCP

Official
by Apitomy

Verify Build Workflow

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-mcp

Configure in Claude Code

The easiest way is to use the claude mcp add command:

claude mcp add apitomy-data-models apitomy-data-models-mcp

Tool 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

api://{session}/info

Document metadata

api://{session}/paths

List of paths/channels

api://{session}/schemas

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 document

Create 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 YAML

Transform a Swagger document

> Load my swagger.json as "legacy"
> Transform it to OpenAPI 3.0
> Validate the transformed document
> Save it to openapi3.json

Development

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 linter

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 tools
document_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_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_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

    B3/5.0

    Scored across 102 tools

    Disambiguation3/5

    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.

    Naming Consistency3/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityActive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 context
      50
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server providing token-efficient access to OpenAPI/Swagger specs via MCP Resources for client-side exploration.
      582 npm
      76
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A server implementation of the Model Context Protocol (MCP) that provides REST API endpoints for managing and interacting with MCP resources.
      -