What OpenAPI versions does specrun support?

The server converts OpenAPI specs into queryable tools. Check the documentation for specific version support (OpenAPI 3.0 and 3.1 are most common), or test with your spec directly.

How do I authenticate with APIs that require API keys or OAuth?

Authentication details depend on your OpenAPI spec definition. The server converts the spec as-is, so ensure your spec includes security schemes and pass credentials as needed when querying endpoints.

Can I use specrun with private or local OpenAPI specs?

Yes, you can load specs from local files or remote URLs. Provide the spec path or URL when initializing the server, and it will convert those endpoints into tools.

What happens if an API endpoint is down or returns an error?

The server will pass through the API's error response. Handle errors in your agent logic or check the endpoint's availability before querying.

Is there a cost to using specrun?

Specrun itself is open-source (installed via npm). You only pay for API calls made to the endpoints defined in your OpenAPI spec.

MCP ServerSTDIOOfficialv1.4.0

Pavelpiha Specrun MCP Server

Convert OpenAPI specifications into executable tools that query live API endpoints. For developers building AI agents or automation workflows that need to interact with REST APIs defined in OpenAPI format.

io.github.pavelpiha/specrun

Try MCP with AI models View source

Hosted URL

Local install

Transport

STDIO

Auth

No auth required

What the Pavelpiha Specrun MCP server does

How models use it and what it is built for.

Connect to Pavelpiha Specrun

Local install — runs as a subprocess.

npx @pavelpiha/specrun@1.4.0

Resources

Where to find authoritative docs and source for Pavelpiha Specrun.

Source repository

Example prompts for Pavelpiha Specrun

Paste any of these into Agent Studio after connecting Pavelpiha Specrun.

Load the OpenAPI spec from https://api.example.com/openapi.json and list available endpoints
Query the /users endpoint using the spec and fetch all active users
Show me what parameters the POST /orders endpoint accepts according to the spec
Execute a GET request to /products with filter=electronics using the loaded OpenAPI definition

Pavelpiha Specrun MCP server — FAQ

Common questions about connecting and running Pavelpiha Specrun.

What OpenAPI versions does specrun support?
The server converts OpenAPI specs into queryable tools. Check the documentation for specific version support (OpenAPI 3.0 and 3.1 are most common), or test with your spec directly.
How do I authenticate with APIs that require API keys or OAuth?
Authentication details depend on your OpenAPI spec definition. The server converts the spec as-is, so ensure your spec includes security schemes and pass credentials as needed when querying endpoints.
Can I use specrun with private or local OpenAPI specs?
Yes, you can load specs from local files or remote URLs. Provide the spec path or URL when initializing the server, and it will convert those endpoints into tools.
What happens if an API endpoint is down or returns an error?
The server will pass through the API's error response. Handle errors in your agent logic or check the endpoint's availability before querying.
Is there a cost to using specrun?
Specrun itself is open-source (installed via npm). You only pay for API calls made to the endpoints defined in your OpenAPI spec.

Skip the local setup — run MCP in your browser

MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 60+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.

Open Agent Studio