Skip to main content
Glama
OpenAPI Sync MCP

OpenAPI Sync MCP

by jhlee0409

OpenAPI Sync MCP

CI MCP License: MIT MCP Badge

A high-performance MCP server for OpenAPI specifications. Parse, diff, track dependencies, and generate code - all from your AI assistant.

Built with Rust for speed and minimal resource usage.

Features

  • Dependency Graph - Know which endpoints break when you change a schema

  • Smart Diff - Detect breaking changes before they hit production

  • Paginated Parsing - Handle massive specs without overwhelming context

  • 24h Cache - Fast repeated queries with HTTP cache support

  • Multi-target Codegen - TypeScript, Rust, Python from one spec

Related MCP server: OpenAPI Schema Explorer

Quick Start

npm install -g @jhlee0409/openapi-sync-mcp

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "oas": {
      "command": "openapi-sync-mcp"
    }
  }
}

Tools

Tool

Description

oas_parse

Parse and validate OpenAPI spec (with pagination)

oas_deps

Find affected endpoints when a schema changes

oas_diff

Compare two spec versions, detect breaking changes

oas_status

Check cache status

oas_generate

Generate TypeScript/Rust/Python code

Code Generation Targets

typescript-types · typescript-fetch · typescript-axios · typescript-react-query · rust-serde · rust-reqwest · python-pydantic · python-httpx

Installation

# npm (recommended)
npm install -g @jhlee0409/openapi-sync-mcp

# Cargo
cargo install openapi-sync-mcp

# Or download from GitHub Releases

Troubleshooting

Server not responding?

chmod +x openapi-sync-mcp
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | openapi-sync-mcp

Cache issues? Delete .openapi-sync.cache.json or use use_cache: false.

Development

cargo test          # Run tests
cargo fmt --check   # Check formatting
cargo clippy        # Lint

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for loading and exploring OpenAPI/Swagger specifications, enabling AI assistants to dynamically browse API contracts by loading specs, searching endpoints, inspecting schemas, and retrieving operations.
      20 npm
      3
      MIT