MCP.so
Sign In

OpenAPI MCP Server

@asabya

Repository

About OpenAPI MCP Server

fork of openapi-mcp-server v1.2.0-beta04

#openapi#mcp-server#api-proxy

Config

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

{
  "mcpServers": {
    "openapi-mcp-server": {
      "command": "npx",
      "args": [
        "openapi-mcp-server",
        "/abs/path/to/openapi.json"
      ]
    }
  }
}

Tools

2

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

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

Overview

What is OpenAPI MCP Server?

OpenAPI MCP Server is an MCP proxy that converts any OpenAPI v3.1 compliant API into tools usable by Claude Desktop or other MCP clients. It allows developers to interact with local and remote APIs through natural language, discovering endpoints, understanding parameters, and making API calls automatically.

How to use OpenAPI MCP Server?

Configure Claude Desktop by adding the MCP server entry in claude_desktop_config.json with the command npx openapi-mcp-server /absolute/path/to/openapi.json. Restart Claude Desktop, then start asking natural-language questions about your API.

Key features of OpenAPI MCP Server

  • Converts OpenAPI endpoints into Claude‑usable tools automatically
  • Supports file uploads via multipart/form-data (local files only)
  • Works with any OpenAPI v3.1 compliant API
  • Provides CLI tool for testing endpoints programmatically
  • Offers programmatic API (OpenAPIToMCPConverter, HttpClient) for custom integrations

Use cases of OpenAPI MCP Server

  • Test local development APIs through conversational debugging
  • Quickly prototype integrations with third‑party APIs
  • Explore and learn new APIs by asking natural‑language questions
  • Automate file upload workflows (profile pictures, documents, batch uploads)

FAQ from OpenAPI MCP Server

Which OpenAPI versions are supported?

Only OpenAPI v3.1 specifications are currently supported.

Are remote file URLs supported for uploads?

No, only local file paths are supported; remote URLs are not handled.

What are the security considerations for file uploads?

File paths resolve relative to the current working directory. Access is restricted to files the user can read, and sensitive files like SSH keys require explicit user confirmation. File contents are read only when making the actual API request.

How does the server handle large files?

Large files are streamed directly from disk to the API, with memory usage optimized and progress reporting available. Maximum file size is determined by the target API.

What format are API responses expected to be?

Response handling is optimized for JSON and text responses; streaming responses are not yet implemented.

Frequently asked questions

Which OpenAPI versions are supported?

Only OpenAPI v3.1 specifications are currently supported.

Are remote file URLs supported for uploads?

No, only local file paths are supported; remote URLs are not handled.

What are the security considerations for file uploads?

File paths resolve relative to the current working directory. Access is restricted to files the user can read, and sensitive files like SSH keys require explicit user confirmation. File contents are read only when making the actual API request.

How does the server handle large files?

Large files are streamed directly from disk to the API, with memory usage optimized and progress reporting available. Maximum file size is determined by the target API.

What format are API responses expected to be?

Response handling is optimized for JSON and text responses; streaming responses are not yet implemented.

Comments

Basic information

Category

Other

License

MIT

Transports

stdio

Author

asabya

More Other MCP servers

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

ICSS

chokcoco

不止于 CSS

20.7K

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K