Which integrations are available for this server?

Parses Swagger 2.0 and OpenAPI 3.x specifications, exposing API structure through MCP tools for browsing, searching, and calling APIs defined by the spec.

How do I use swagger-api-mcp-server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@swagger-api-mcp-server load the Petstore API spec and list all endpoints" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

swagger-api-mcp-server

by NekoTarou

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

Swagger API MCP Server

License Build & Test npm version npm downloads Node.js Version MCP Badge

English | 中文

An MCP (Model Context Protocol) server that parses Swagger 2.0 and OpenAPI 3.x specifications, exposing API structure through MCP tools. Features a local file-cache architecture that reduces token usage by 85-95% compared to inline responses.

Features

Swagger 2.0 & OpenAPI 3.x — Full dual-format support
Smart Caching — Spec parsed once, stored as local JSON files; tools return compact summaries + file paths (~200 chars vs 5-20KB)
11 MCP Tools — Load, browse, search, call APIs, and manage auth dynamically
3 MCP Prompts — Guided workflows for exploring, searching, and integrating APIs
3 MCP Resources — Direct access to cached API info, endpoints, and schemas
Two Transport Modes — stdio (for CLI/IDE integration) and HTTP (for multi-session web use)
2-Phase API Calls — Preview requests before executing them
Zero External Parsers — Custom $ref resolver with circular reference protection

Related MCP server: Swagger to MCP

Prerequisites

Node.js >= 24

Quick Start

Install from npm

npm install -g swagger-api-mcp-server

Or clone and build

git clone https://github.com/NekoTarou/swagger-api-mcp-server.git
cd swagger-api-mcp-server
npm install
npm run build

Run

# stdio mode (default) — for MCP clients like Claude Desktop
npm start

# Auto-load a spec on startup
SWAGGER_URL=https://petstore.swagger.io/v2/swagger.json npm start

# HTTP mode — multi-session with Express
npm run start:http

MCP Client Configuration

Claude Desktop

Add to your Claude Desktop config file (claude_desktop_config.json):

{
  "mcpServers": {
    "swagger-api": {
      "command": "npx",
      "args": ["-y", "swagger-api-mcp-server"],
      "env": {
        "SWAGGER_URL": "https://petstore.swagger.io/v2/swagger.json"
      }
    }
  }
}

Cursor / VS Code

Add to your MCP settings:

{
  "mcpServers": {
    "swagger-api": {
      "command": "npx",
      "args": ["-y", "swagger-api-mcp-server"],
      "env": {
        "SWAGGER_URL": "https://your-api.example.com/openapi.json"
      }
    }
  }
}

Tools

Tool	Description
`swagger_load_spec`	Load a Swagger/OpenAPI spec from URL, parse and cache it
`swagger_update_cache`	Re-fetch spec and rebuild cache
`swagger_get_info`	Get API metadata (title, version, servers, auth schemes)
`swagger_list_tags`	List all tags with endpoint counts
`swagger_list_paths`	List endpoints with filtering (tag, method, keyword) and pagination
`swagger_get_endpoint`	Get endpoint summary + cached file path for full details
`swagger_list_schemas`	List schema definitions with filtering and pagination
`swagger_get_schema`	Get schema summary + cached file path for full definition
`swagger_search`	Search across endpoints and schemas by keyword
`swagger_call_api`	Execute HTTP requests with 2-phase confirmation
`swagger_set_auth`	Dynamically set or clear the Authorization header at runtime

Prompts

Prompt	Arguments	Description
`swagger_explore_api`	`url`	Guided workflow to load and fully explore an API spec
`swagger_find_endpoint`	`keyword`	Search for endpoints by keyword and view full details
`swagger_integrate_api`	`url`, `task`	Find the right endpoint for a task and execute an API call

Resources

Resource	URI	Description
`api-info`	`swagger://api/info`	API basic information (title, version, servers, auth)
`api-endpoints`	`swagger://api/endpoints`	Index of all API endpoints
`api-schemas`	`swagger://api/schemas`	Index of all schema/model definitions

Cache Architecture

When a spec is loaded, it's parsed once and stored as structured JSON files:

.swagger-cache/
├── meta.json              # Cache metadata (URL, counts, timestamp)
├── info.json              # Full API info (title, servers, auth)
├── tags.json              # Tag list with endpoint counts
├── paths-index.json       # Endpoint index for fast lookup
├── schemas-index.json     # Schema index for fast lookup
├── endpoints/             # One file per endpoint (deep-resolved)
│   └── GET__users__{id}.json
└── schemas/               # One file per schema (deep-resolved)
    └── User.json

Tools return brief summaries with file paths. The LLM reads full details on demand via the Read tool — saving 85-95% of tokens per call.

Environment Variables

Variable	Default	Description
`SWAGGER_URL`	(empty)	Auto-load spec on startup
`TRANSPORT`	`stdio`	Transport mode: `stdio` or `http`
`MCP_PORT`	`3000`	HTTP server port
`MCP_HOST`	`0.0.0.0`	HTTP server host
`API_BASE_URL`	(empty)	Override API base URL for calls
`API_AUTH_TOKEN`	(empty)	Initial Authorization header value (can be updated at runtime via `swagger_set_auth`)
`CACHE_DIR`	`.swagger-cache`	Custom cache directory path
`SESSION_TIMEOUT_MS`	`1800000`	HTTP session timeout (30 min)
`MAX_SESSIONS`	`100`	Max concurrent HTTP sessions

Development

npm run dev            # Dev mode with auto-reload (tsx watch)
npm test               # Run tests
npm run build          # TypeScript compilation → dist/
npm run clean          # Remove dist/

License

MIT

This server cannot be installed

license - permissive license

quality - not tested

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.

Related MCP Servers

Swagger MCP
API Testing Developer Tools Documentation Access
IAGeneration
-
license
-
quality
-
maintenance
Dynamically generates MCP tools from Swagger/OpenAPI specifications by extracting swagger.json files at runtime. Enables natural language interaction with any REST API that has Swagger documentation.
Last updated 2025-08-14
Swagger to MCP
API Testing Developer Tools App Automation
suhailtajshaik
A
license
-
quality
-
maintenance
Automatically converts Swagger/OpenAPI specifications into dynamic MCP tools, enabling interaction with any REST API through natural language by loading specs from local files or URLs.
Last updated 2025-12-05
OpenAPI MCP Server
API Testing Documentation Access Developer Tools
teddy258
A
license
-
quality
B
maintenance
Exposes OpenAPI specifications as MCP tools, enabling AI assistants to explore and understand API structures, endpoints, schemas, and documentation through semantic queries.
Last updated 2026-05-18
24
MIT
swagger-mcp
Documentation Access Developer Tools
emreycolakoglu
A
license
A
quality
B
maintenance
A read-only MCP server for navigating OpenAPI / Swagger specifications, enabling agents to search endpoints, retrieve parameters and schemas, and inspect authentication without loading the full spec into context.
Last updated 2026-07-08
9
16
MIT

View all related MCP servers

Related MCP Connectors

Apis Guru
APIs.guru MCP — keyless directory of 2,500+ public APIs and their OpenAPI specs.
DATPAQ
34 production API tools over one hosted MCP endpoint.
surf
Point Gecko at an OpenAPI spec; get first-call-correct, auth-hidden agent tools.

View all MCP Connectors

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/NekoTarou/swagger-api-mcp-server'

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

Swagger API MCP Server

Features

Prerequisites

Quick Start

Install from npm

Or clone and build

Run

MCP Client Configuration

Claude Desktop

Cursor / VS Code

Tools

Prompts

Resources

Cache Architecture

Environment Variables

Development

License

Maintenance

Resources

Looking for Admin?

Related MCP Servers

Swagger MCP

Swagger to MCP

OpenAPI MCP Server

swagger-mcp

Related MCP Connectors

Latest Blog Posts

MCP directory API