Advertise
MCP.so
Sign In
O

Openapi Navigator MCP Server

@mgaruccio

Repository

Basic information

Category

Other

Transports

stdio

Author

mgaruccio

Submitted by

Mike Garuccio

About Openapi Navigator MCP Server

MCP server for handling large openapi specs

#openapi#api-navigator#mcp-server

Openapi Navigator MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "openapi-navigator": {
      "command": "uvx",
      "args": [
        "openapi-navigator"
      ],
      "env": {}
    }
  }
}

Openapi Navigator MCP Server tools

9

Load an OpenAPI specification from a local file. Args: file_path: Absolute path to the OpenAPI spec file (YAML or JSON) spec_id: Optional custom identifier for the spec. If not provided, will use 'file:{file_path}' Returns: The spec ID that was assigned to the loaded specification Note: File path must be absolute for security reasons.

Load an OpenAPI specification from a URL. Args: url: URL to the OpenAPI spec (YAML or JSON) spec_id: Optional custom identifier for the spec. If not provided, will use 'url:{url}' Returns: The spec ID that was assigned to the loaded specification

Unload an OpenAPI specification from memory. Args: spec_id: ID of the loaded spec to unload Returns: Confirmation message

List all currently loaded OpenAPI specifications. Returns: List of spec IDs that are currently loaded

Get the complete operation definition for a specific endpoint. Args: spec_id: ID of the loaded spec to query path: API path (e.g., '/users/{id}') method: HTTP method (e.g., 'GET', 'POST') Returns: The raw operation object from the OpenAPI spec, or None if not found

Search endpoints using fuzzy matching across paths, summaries, and operation IDs. To get a full list of all endpoints, use an empty string "" or a very short query like "a" as the search term. The search will return all endpoints with a relevance score of 100 when the query is very short. Args: spec_id: ID of the loaded spec to query query: Search query string. Use "" or "a" to get all endpoints. Returns: List of matching endpoints with relevance scores

Get a specific schema definition from a loaded OpenAPI specification. Args: spec_id: ID of the loaded spec to query schema_name: Name of the schema to retrieve Returns: The raw schema object from the OpenAPI spec, or None if not found

Search schema names using fuzzy matching. To get a full list of all schemas, use an empty string "" or a very short query like "a" as the search term. The search will return all schemas with a relevance score of 100 when the query is very short. Args: spec_id: ID of the loaded spec to query query: Search query string. Use "" or "a" to get all schemas. Returns: List of matching schema names with relevance scores

Get comprehensive metadata about a loaded OpenAPI specification. This includes information about the spec version, title, description, base path, servers, contact info, license, and counts of endpoints and schemas. Args: spec_id: ID of the loaded spec to query Returns: Dictionary containing spec metadata including base path and help text

Overview

What is Openapi Navigator?

Openapi Navigator is an MCP server that makes OpenAPI specifications easily accessible to AI agents. It loads specs from local files or URLs and allows natural language searching of endpoints and schemas.

How to use Openapi Navigator?

Install the server with uvx openapi-navigator and add the JSON configuration to your MCP client settings. Once connected, use commands like load_spec, search_endpoints, and get_endpoint to explore and query OpenAPI specifications.

Key features of Openapi Navigator

  • Load specs from local files or URLs (OpenAPI 3.x & Swagger 2.x)
  • Smart search with fuzzy matching for endpoints and schemas
  • Manage multiple API specifications simultaneously
  • Preserves $ref structures for agent decision-making
  • Fast indexing for instant lookups and searches

Use cases of Openapi Navigator

  • API exploration – quickly understand API structure and capabilities
  • Code generation – extract endpoint/schema info for automated code creation
  • Documentation – generate comprehensive API documentation
  • Integration planning – discover API features before implementation
  • Testing – find endpoints and parameters for test automation

Frequently asked questions

1

What OpenAPI versions does Openapi Navigator support?

It supports OpenAPI 3.x and Swagger 2.x specifications.

2

Can I load specs from a URL?

Yes, you can load specs from both local files and URLs.

3

Does the server handle multiple APIs at once?

Yes, it allows you to manage several API specifications simultaneously.

4

How does the search work?

The server uses fuzzy matching so you can search endpoints and schemas using natural language queries.

5

What does "reference preservation" mean?

The server maintains the `$ref` structures found in OpenAPI specs, keeping them intact for agent decision-making.

Comments

More Other MCP servers

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K
Advertise