Project 14 / 34

Swagger MCP

Developers ask their AI assistant how an API works and get the answer right inside the editor, with no trip to the docs site.

Year: 2025
Platform: IDE extension
Type: Personal
Status: Shipped

swagger-mcp — bookings.ts

bookings.tsusers.tsapi.ts

1import { api } from "../lib/api";
2import type { BookingInput } from "../types";
3
4export async function createBooking(
5  input: BookingInput,
6) {
7  return api.post("/bookings", {
8    listingId: input.listingId,
9    checkIn: input.checkIn,
10    checkOut: input.checkOut,
11    guests: input.guests,
12  });
13}

Chat

What does POST /bookings need?

swagger-mcp · get_endpoint

Four required fields:

listingIdstringcheckIndatecheckOutdateguestsinteger

Returns 201 with a Booking.

Ask about your API…

Overview

A TypeScript Model Context Protocol server that exposes Swagger and OpenAPI specifications to AI assistants. MCP clients such as VS Code, Claude Desktop and Cursor can explore endpoints, inspect request and response schemas, search by parameter or keyword, and generate example API calls without leaving the client.

What it does

Loads Swagger/OpenAPI specifications as MCP resources
Inspect endpoints and view request/response schemas
Search endpoints by parameter or keyword
Show full method details including HTTP methods and schema
Generate example API calls
Provides instant documentation without visiting the Swagger site
Streamlines development workflows and accelerates API understanding

Built with

Typescript
NodeJS
Model Context Protocol
Zod