Spark
Sign In
MCP Connector

Explore and Summarize OpenAPI Specs

OpenAPI MCP Server lets Claude and Cursor search and explore any OpenAPI spec via oapis.org, in plain language.

Get from source
Snaggle AI
Own this? Claim it
77
Spark score
out of 100
Updated 2 months ago
Source checked Aug 10, 2026
Version 1.2.0-beta04
Models
claudeuniversal
Add to Favorites

Why it matters

Effortlessly search and understand complex OpenAPI specifications. This asset provides plain-language summaries and detailed operation information, making API exploration intuitive.

Outcomes

What it gets done

01

Identify and retrieve OpenAPI specifications.

02

Generate concise summaries of API functionalities.

03

Extract detailed information about specific API endpoints.

04

Support for both JSON and YAML OpenAPI formats.

Source

Get it from source

Spark does not host a copy of it.

Open source

Reports

Agent outcome reports

No reports yet

Capabilities

Tools your agent gets

search_openapi_specs

Search and explore OpenAPI specifications through oapis.org

get_openapi_summary

Get a plain-language summary of any OpenAPI specification

extract_api_operations

Extract details about specific API operations from OpenAPI specs

Overview

OpenAPI MCP Server

OpenAPI MCP Server explains OpenAPI specifications in plain language for Claude and Cursor, giving an overview of an API and detail on specific operations. Use it when Claude or Cursor needs to explain an OpenAPI specification or a specific endpoint in plain language.

What it does

OpenAPI MCP Server is an MCP server for Claude and Cursor that enables searching and exploring OpenAPI specifications through oapis.org. Rather than reading a raw OpenAPI or Swagger document yourself, it walks a three-step process: figuring out the OpenAPI identifier you need, requesting a plain-language summary of it, and determining which specific endpoints you need before explaining how they work, also in plain language.

When to use - and when NOT to

Use it when you want Claude or Cursor to explain an API's OpenAPI specification in plain language, getting an overview of what an API offers, or drilling into how a specific operation works, instead of you parsing the raw JSON or YAML spec yourself. It supports both JSON and YAML OpenAPI formats and has been tested with Claude Desktop and Cursor specifically. It is a discovery and explanation tool for OpenAPI specs, not an API client that actually calls the endpoints it describes.

Capabilities

The server exposes an overview capability for any OpenAPI specification, translating the spec into a simple-language summary, and a detail capability for retrieving information about specific API operations, again explained in plain language rather than raw schema. Both JSON and YAML OpenAPI formats are supported.

How to install

The hosted MCP URL is https://openapi-mcp.openapisearch.com/mcp, installable directly for supported clients or added manually for others pointing at that URL. For local testing, run the server with wrangler dev, then connect the MCP Inspector with npx @modelcontextprotocol/inspector.

Who it's for

Developers who want Claude or Cursor to explain an OpenAPI specification and its endpoints in plain language, instead of reading raw API documentation or spec files directly.

Source README

OpenAPI MCP Server

janwilmake/openapi-mcp-server context

A Model Context Protocol (MCP) server for Claude/Cursor that enables searching and exploring OpenAPI specifications through oapis.org.

The MCP works by applying a 3 step process:

  1. It figures out the openapi identifier you need
  2. It requests a summary of that in simple language
  3. It determines which endpoints you need, and checks out how exactly they work (again, in simple language)

Features

  • Get an overview of any OpenAPI specification
  • Retrieve details about specific API operations
  • Support for both JSON and YAML formats
  • Tested with Claude Desktop and Cursor

Installation

Install OpenAPI MCP Server

For other clients, use MCP URL: https://openapi-mcp.openapisearch.com/mcp

Local testing

First run the server

wrangler dev

Then run the mcp inspector:

npx @modelcontextprotocol/inspector

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.