OpenAPI

by janwilmake

822 stars

16 downloads

Not rated

GitHub Website

About

This tool creates a Model Context Protocol (MCP) server that acts as a proxy for any API that has an OpenAPI v3.1 specification. This allows you to use Claude Desktop to easily interact with both local and remote server APIs.

Details

Author: janwilmake
Repository: janwilmake/openapi-mcp-server
GitHub stars: 822
Downloads: 16
License: MIT License
Categories: Developer Tools, AI, Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name OpenAPI

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @highlight/mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

From the repository

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

`getApiOverview`

Get an overview of an OpenAPI specification. This should be the first step when working with any API. - openai - OpenAI is a large AI service provider providing state of the art models in various modalities. - github - GitHub is where one hosts their code in a central location, to collaborate with others - podscan.fm - Search through podcast transcripts, get alerts - x - Official Twitter/X API - cloudflare - Cloudflare provides content delivery network services, cloud cybersecurity, DDoS mitigation, wide area network services, Domain Name Service, and ICANN-accredited domain registration services - npm-registry - supabase - Create hosted Postgres Databases with API - hackernews - Readonly API for posts, comments, and profiles from news.ycombinator.com - stripe - Create a paywall for your app or invoices - slack - A very common app used for communication at work - vercel - Vercel is a cloud hosting solution for full stack applications - val-town - Host serverless APIs - firecrawl - API for interacting with Firecrawl services to perform web scraping and crawling tasks. - playht - The PlayHT's API API allows developers to Realtime Text to Speech streaming Stream audio bytes from text, Convert long form Text to Speech Generate audio from text, and Voice Cloning Instant Cloning. - serper - The worlds fastest and cheapest google search api - replicate - brandwatch - Watch social media about your brand - jina-reader - Read webpages in markdown, html, or screenshot - upstash-redis - Control a Redis database over API - upstash-qstash - Scheduling and batching API calls - upstash-vector - Control a Vector database over API - digitalocean - apisguru - Public API to find OpenAPIs on https://apis.guru - groq - Cloud AI Provider with multiple transformer LLMs and other modalities, with very fast inference - notion-dbs - Notion Databases API - posthog-capture-api - Posthog is a Product analytics platform allowing companies to track and understand their users - google-analytics4 - The Google Analytics Admin API allows for programmatic access to the Google Analytics 4 (GA4) configuration data and is only compatible with GA4 properties - google-analytics3 - Views and manages your Google Analytics data (GA3) - anthropic-message-api - probo-nl - whatsapp-business - The WhatsApp Business Platform gives medium to large businesses the ability to connect with customers at scale. You can start WhatsApp conversations with your customers in minutes, send them care notifications or purchase updates, offer personalized services, and provide support in the channel that your customers prefer. - shopify - Shopify Admin API - twilio-messaging - huggingface - doppio - multion - browserless - Web browsing API - bol-com-retailer - Dutch shopping platform - statusbrew - Social media planning API for facebook, instagram, twitter, linkedin, google my business, pinterest, youtube, and tiktok. - swagger-validator - Validators for swagger 2.0 and 3.x specifications of OpenAPIs - google-mail - Manage GMail - youtube-data - The YouTube Data API v3 is an API that provides access to YouTube data, such as videos, playlists, and channels. - google-sheets - google-drive - google-secret-manager - flyio - vapi - klippa - uberduck - twilio - saltedge - Bank integrations - google-search-console - aws-cloudwatch-insights - aws-cloudfront - aws-email - aws-s3-control - aws-s3 - aws-sagemaker - aws-sagemaker-edge - aws-sagemaker-featureStore - bunq - hootsuite - robocorp - sendgrid - google-calendar - google-docs

`getApiOperation`

Get details about a specific operation from an OpenAPI specification. Use this after getting an overview. - openai - OpenAI is a large AI service provider providing state of the art models in various modalities. - github - GitHub is where one hosts their code in a central location, to collaborate with others - podscan.fm - Search through podcast transcripts, get alerts - x - Official Twitter/X API - cloudflare - Cloudflare provides content delivery network services, cloud cybersecurity, DDoS mitigation, wide area network services, Domain Name Service, and ICANN-accredited domain registration services - npm-registry - supabase - Create hosted Postgres Databases with API - hackernews - Readonly API for posts, comments, and profiles from news.ycombinator.com - stripe - Create a paywall for your app or invoices - slack - A very common app used for communication at work - vercel - Vercel is a cloud hosting solution for full stack applications - val-town - Host serverless APIs - firecrawl - API for interacting with Firecrawl services to perform web scraping and crawling tasks. - playht - The PlayHT's API API allows developers to Realtime Text to Speech streaming Stream audio bytes from text, Convert long form Text to Speech Generate audio from text, and Voice Cloning Instant Cloning. - serper - The worlds fastest and cheapest google search api - replicate - brandwatch - Watch social media about your brand - jina-reader - Read webpages in markdown, html, or screenshot - upstash-redis - Control a Redis database over API - upstash-qstash - Scheduling and batching API calls - upstash-vector - Control a Vector database over API - digitalocean - apisguru - Public API to find OpenAPIs on https://apis.guru - groq - Cloud AI Provider with multiple transformer LLMs and other modalities, with very fast inference - notion-dbs - Notion Databases API - posthog-capture-api - Posthog is a Product analytics platform allowing companies to track and understand their users - google-analytics4 - The Google Analytics Admin API allows for programmatic access to the Google Analytics 4 (GA4) configuration data and is only compatible with GA4 properties - google-analytics3 - Views and manages your Google Analytics data (GA3) - anthropic-message-api - probo-nl - whatsapp-business - The WhatsApp Business Platform gives medium to large businesses the ability to connect with customers at scale. You can start WhatsApp conversations with your customers in minutes, send them care notifications or purchase updates, offer personalized services, and provide support in the channel that your customers prefer. - shopify - Shopify Admin API - twilio-messaging - huggingface - doppio - multion - browserless - Web browsing API - bol-com-retailer - Dutch shopping platform - statusbrew - Social media planning API for facebook, instagram, twitter, linkedin, google my business, pinterest, youtube, and tiktok. - swagger-validator - Validators for swagger 2.0 and 3.x specifications of OpenAPIs - google-mail - Manage GMail - youtube-data - The YouTube Data API v3 is an API that provides access to YouTube data, such as videos, playlists, and channels. - google-sheets - google-drive - google-secret-manager - flyio - vapi - klippa - uberduck - twilio - saltedge - Bank integrations - google-search-console - aws-cloudwatch-insights - aws-cloudfront - aws-email - aws-s3-control - aws-s3 - aws-sagemaker - aws-sagemaker-edge - aws-sagemaker-featureStore - bunq - hootsuite - robocorp - sendgrid - google-calendar - google-docs

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "openapi": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

# OpenAPI MCP Server [![janwilmake/openapi-mcp-server context](https://badge.forgithub.com/janwilmake/openapi-mcp-server?excludePathPatterns=*.yaml)](https://uithub.com/janwilmake/openapi-mcp-server?excludePathPatterns=*.yaml) A Model Context Protocol (MCP) server for Claude/Cursor that enables searching and exploring OpenAPI specifications through oapis.org. - Demo: https://x.com/janwilmake/status/1903497808134496583 - HN Thread: https://news.ycombinator.com/item?id=43447278 - OpenAPISearch: https://github.com/janwilmake/openapisearch - OAPIS: https://github.com/janwilmake/oapis 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](https://img.shields.io/badge/Install_MCP-OpenAPI%20MCP%20Server-1e3a8a?style=for-the-badge)](https://installthismcp.com/OpenAPI%20MCP%20Server?url=https%3A%2F%2Fopenapi-mcp.openapisearch.com%2Fmcp) 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 ```

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

getApiOverview

getApiOperation

Claude Desktop / Cursor

Linux

Macos

Windows

Install

More like this

Sequential Thinking

Sentry

Github

Filesystem

EverArt

Google Drive

`getApiOverview`

`getApiOperation`