pavelpiha avatar

Specrun

pavelpiha/specrun

Drop an OpenAPI spec file in a folder and this server turns each endpoint into an MCP tool you can call directly from Claude. It handles both OpenAPI 3.x and Swagger 2.0, generates tool names from operation IDs or paths, and manages auth through a simple .env file using patterns like GITHUB_API_KEY or CARS_BEARER_TOKEN. You get automatic namespace isolation when loading multiple specs, batch execution for running the same endpoint with different inputs, and live reloading when you update your .env. Built on FastMCP for TypeScript. Useful when you want to give Claude access to any REST API without writing integration code for each one.

GitHub stars
5
tool
1
transport
STDIO
last updated
Feb 17, 2026

Tools

1 tools

Public tool metadata for what this MCP can expose to an agent.

specrun_batchRun any tool with an array of inputs and return a consolidated JSON resource with per-item outputs.

Run any tool with an array of inputs and return a consolidated JSON resource with per-item outputs.

No parameter schema in public metadata yet.

Sponsors

Readme

SpecRun

An MCP server that turns OpenAPI specifications into MCP tools. Scans a folder for OpenAPI spec files and automatically generate corresponding tools. These tools can then be used in any MCP client to interact with the APIs defined by the specs, with built-in support for authentication and server URL management via a simple `.env` file.

Built with FastMCP for TypeScript.

✨ Features


View the full README on GitHub

Details

Repository
github.com/pavelpiha/specrun
Package
@pavelpiha/specrun
Transport
STDIO
Registry
MCP registry, active