What can you do with this server?

The mcp-openapi-runner server exposes any OpenAPI 3.x API (JSON or YAML, local or remote) to Claude as natural language-accessible tools, with zero manual configuration. Two core tools: * list_endpoints — Discover all available API operations, grouped by tag, with their operationIds, HTTP methods, paths, and parameters * call_endpoint — Execute any operation by specifying its operationId, along with path/query/header parameters and a body for POST/PUT/PATCH requests Additional capabilities: * Automatically generates tool schemas by resolving $ref references directly from the OpenAPI spec * Supports Bearer token, API key, and Basic authentication via environment variables * Filter exposed endpoints by path, tag, or operationId pattern * Override the base server URL and add custom headers to all requests * Works with MCP clients like Claude Desktop, Claude Code, Cursor, and Cline Typical workflow: Start with list_endpoints to discover what's available, then use call_endpoint with the appropriate operationId to take action — for example, listing/adding/updating pets, managing store inventory, or handling user accounts in the Swagger Petstore demo.

Which integrations are available for this server?

Enables interaction with the GitHub REST API, allowing for management of repositories, issues, and other platform features via its OpenAPI specification. Provides tools for interacting with the Stripe API to handle payments, subscriptions, and financial data through its OpenAPI specification.

mcp-openapi-runner

by saurav61091

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

mcp-openapi

npm version License: MIT Node.js MCP

Turn any OpenAPI spec into MCP tools for Claude — zero config, instant API access.

Point mcp-openapi-runner at any OpenAPI 3.x spec and Claude can call every endpoint through natural language. No custom integration code. No manual tool definitions. One line of config.

Why mcp-openapi?

Without mcp-openapi	With mcp-openapi
Write custom MCP server per API	One config line per API
Define tool schemas manually	Auto-generated from OpenAPI spec
Handle auth, params, body yourself	Built-in auth + parameter handling
Maintain code as API evolves	Spec changes = tools update automatically

Related MCP server: FastMCP OpenAPI

Quick start

Add to your Claude Desktop / Claude Code / Cursor / Cline MCP config:

{
  "mcpServers": {
    "petstore": {
      "command": "npx",
      "args": ["-y", "mcp-openapi-runner", "--spec", "https://petstore3.swagger.io/api/v3/openapi.json"]
    }
  }
}

That's it. Claude can now discover and call every endpoint in that API.

Example conversation

You: What pets are available? Add a new dog named Buddy.
Claude: Let me check what's available. [calls list_endpoints → discovers findPetsByStatus, addPet, ...] [calls call_endpoint → findPetsByStatus with status=available]
There are 3 pets currently available. Now I'll add Buddy... [calls call_endpoint → addPet with {"name":"Buddy","status":"available"}]
Done! Buddy has been added with ID 12345.

Features

Zero config — just point at a spec URL or file
Any OpenAPI 3.x spec — JSON or YAML, local or remote, $ref auto-resolved
Auto-generated operationIds — works even when the spec doesn't define them
Built-in auth — Bearer, API key, Basic auth via environment variables
Endpoint filtering — only expose the endpoints you need with --filter
Custom headers — pass arbitrary headers with --header
Server URL override — point at staging/local with --server-url
Two-tool design — simple list_endpoints → call_endpoint workflow
Works everywhere — Claude Desktop, Claude Code, Cursor, Cline, any MCP client

Ready-to-use configs

Stripe

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": ["-y", "mcp-openapi-runner", "--spec", "https://raw.githubusercontent.com/stripe/openapi/master/openapi/spec3.json"],
      "env": {
        "OPENAPI_BEARER_TOKEN": "sk_test_..."
      }
    }
  }
}

GitHub REST API

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "mcp-openapi-runner",
        "--spec", "https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.json",
        "--filter", "repos"],
      "env": {
        "OPENAPI_BEARER_TOKEN": "ghp_..."
      }
    }
  }
}

Your internal API

{
  "mcpServers": {
    "internal": {
      "command": "npx",
      "args": ["-y", "mcp-openapi-runner", "--spec", "http://localhost:8080/openapi.json"],
      "env": {
        "OPENAPI_API_KEY": "dev-key-123"
      }
    }
  }
}

Jira (Atlassian)

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "mcp-openapi-runner",
        "--spec", "https://dac-static.atlassian.com/cloud/jira/platform/swagger-v3.v3.json",
        "--server-url", "https://your-domain.atlassian.net",
        "--filter", "issue"],
      "env": {
        "OPENAPI_BASIC_USER": "you@company.com",
        "OPENAPI_BASIC_PASS": "your-api-token"
      }
    }
  }
}

Authentication

Pass credentials via environment variables:

{
  "mcpServers": {
    "my-api": {
      "command": "npx",
      "args": ["-y", "mcp-openapi-runner", "--spec", "https://api.example.com/openapi.json"],
      "env": {
        "OPENAPI_BEARER_TOKEN": "your-token-here"
      }
    }
  }
}

Variable	Description
`OPENAPI_BEARER_TOKEN`	Bearer token → `Authorization: Bearer <token>`
`OPENAPI_API_KEY`	API key value
`OPENAPI_API_KEY_HEADER`	Header name for API key (default: `X-Api-Key`)
`OPENAPI_BASIC_USER`	HTTP Basic auth username
`OPENAPI_BASIC_PASS`	HTTP Basic auth password

CLI options

npx mcp-openapi-runner --spec <url-or-path> [options]

Options:
  --spec         Path or URL to an OpenAPI 3.x spec (JSON or YAML)
  --server-url   Override the base URL from the spec
  --filter       Only expose endpoints matching a pattern (path, tag, or operationId)
  --header       Add custom header to all requests ("Name: Value", repeatable)
  --help         Show help

Examples

# Basic usage
npx mcp-openapi-runner --spec https://petstore3.swagger.io/api/v3/openapi.json

# Only pet-related endpoints
npx mcp-openapi-runner --spec ./openapi.yaml --filter pets

# Point at local dev server
npx mcp-openapi-runner --spec ./openapi.yaml --server-url http://localhost:3000

# Custom headers
npx mcp-openapi-runner --spec ./openapi.yaml --header "X-Tenant: acme" --header "X-Debug: true"

# With auth
OPENAPI_BEARER_TOKEN=mytoken npx mcp-openapi-runner --spec https://api.example.com/openapi.json

Tools

mcp-openapi-runner exposes exactly two tools:

Tool	Description
`list_endpoints`	Returns all operations grouped by tag with operationIds, methods, paths, and parameters
`call_endpoint`	Executes any operation by `operationId` with path/query/header/body parameters

The two-tool design means Claude always has a clear workflow: discover → call.

How it works

Loads the OpenAPI spec from the given URL or file path
Dereferences all $ref schemas using @apidevtools/swagger-parser
Applies endpoint filter if --filter is set
Registers two MCP tools with the connected client
list_endpoints generates a human+LLM-readable summary of all operations
call_endpoint resolves params, builds the URL, attaches auth + custom headers, returns the response

Requirements

Node.js 18+
OpenAPI 3.x spec (JSON or YAML, local file or URL)

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

OpenAPI to MCP
API Testing Developer Tools App Automation
procoders
A
license
-
quality
D
maintenance
Automatically converts any OpenAPI specification or Postman Collection into an MCP server, enabling AI assistants like Claude to directly interact with REST APIs without writing any code.
Last updated 2025-12-22
Apache 2.0
FastMCP OpenAPI
API Testing Developer Tools App Automation
Agarwal-Saurabh
A
license
-
quality
D
maintenance
Dynamically generates MCP tools from OpenAPI specifications, enabling AI assistants to interact with any REST API through natural language. Supports multiple APIs with authentication, parameter validation, and integration with Claude Desktop and LangChain.
Last updated 2025-10-13
1
MIT
mcp-forge
Developer Tools AI & Machine Learning
hilothefunnydog123-coder
A
license
-
quality
C
maintenance
Turn any OpenAPI spec into a working MCP server — point it at a spec and Claude instantly gets a tool for every endpoint.
Last updated 2026-06-10
MIT
FastMCP Gateway
Developer Tools AI & Machine Learning
4human-ai
F
license
-
quality
D
maintenance
Automatically converts OpenAPI specifications into MCP servers, allowing tools like Claude Desktop to interact with your REST APIs through a standard protocol.
Last updated 2025-11-04

View all related MCP servers

Related MCP Connectors

ToolAPI
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
anythingmcp
Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.
mockmcp
Hosted MCP endpoint with realistic fake data for prototyping agents. 12 tools, no setup.

View all MCP Connectors

Appeared in Searches

An AI-powered golf swing analysis MCP server

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/saurav61091/mcp-openapi'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

mcp-openapi

Why mcp-openapi?

Quick start

Example conversation

Features

Ready-to-use configs

Stripe

GitHub REST API

Your internal API

Jira (Atlassian)

Authentication

CLI options

Examples

Tools

How it works

Requirements

Contributing

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

OpenAPI to MCP

FastMCP OpenAPI

mcp-forge

FastMCP Gateway

Related MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API