Specwise MCP
Validate OpenAPI and JSON Schema and flag breaking changes between spec versions
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.2.9
- Listing updated
- 3 days ago
About Specwise MCP
Specwise MCP is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Specwise can compare a spec file with its version at a git ref such as main, so an agent can check a change before opening a pull request. Diff results label each change breaking, warning, non-breaking or info and suggest a semver bump. Validation reports every error with its JSON Pointer, line and column, plus lint warnings, for OpenAPI 3.x and Swagger 2.0.
A third tool checks a JSON Schema against its meta-schema and, if given, data against the schema. Specs, schemas and data can be local file paths. It runs over stdio with uvx and a RapidAPI or api.market key.
Install
Run in a terminal
claude mcp add specwise-mcp --env RAPIDAPI_KEY='<RAPIDAPI_KEY>' --env API_MARKET_KEY='<API_MARKET_KEY>' -- uvx bytestay-specwise-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"specwise-mcp": {
"command": "uvx",
"args": [
"bytestay-specwise-mcp"
],
"env": {
"RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
"API_MARKET_KEY": "<API_MARKET_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"specwise-mcp": {
"command": "uvx",
"args": [
"bytestay-specwise-mcp"
],
"env": {
"RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
"API_MARKET_KEY": "<API_MARKET_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"specwise-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"bytestay-specwise-mcp"
],
"env": {
"RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
"API_MARKET_KEY": "<API_MARKET_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"specwise-mcp": {
"command": "uvx",
"args": [
"bytestay-specwise-mcp"
],
"env": {
"RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
"API_MARKET_KEY": "<API_MARKET_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"specwise-mcp": {
"command": "uvx",
"args": [
"bytestay-specwise-mcp"
],
"env": {
"RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
"API_MARKET_KEY": "<API_MARKET_KEY>"
}
}
}
}Configuration
RAPIDAPI_KEYYour RapidAPI keyAPI_MARKET_KEYYour api.market key, used when RAPIDAPI_KEY is not setBYTESTAY_MARKETPLACErapidapi or apimarket, when both keys are set (the old name HFL_MARKETPLACE still works)
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- validate_openapi
- Every error with its JSON Pointer, line and column, plus lint warnings.
- diff_openapi
- Each change between two OpenAPI 3.x versions as breaking, warning, non-breaking or info, with a semver suggestion.
- validate_json_schema
- Checks a schema against its meta-schema and, if given, data against the schema.
What it does
- Spec validation
- Errors with pointer, line and column.
- Breaking-change diff
- Classifies each change and suggests a semver bump.
- Git ref comparison
- Compares a file with its version on a branch.
- Schema checks
- Validates schemas and data instances.
- CI gate
- Gates on valid and breaking results.
Good for
- Gate pull requests on breaking API changes
- Validate an OpenAPI file before commit
- Check JSON payloads against a schema
- Choose a semver bump for an API release
Pricing
Freemium
Basic plan free on RapidAPI (15 requests a month); 7-day trial on api.market. Paid plan prices not published
Prices change. Check specwise.bytestay.pt before you buy.
Specwise MCP FAQ
Which spec versions?
OpenAPI 3.x and Swagger 2.0 for validation; OpenAPI 3.x for diffs.
Can it compare against a branch?
Yes, diff_openapi accepts a git ref such as main.
What keys are needed?
RapidAPI or api.market.
Free?
Basic is free on RapidAPI at 15 requests a month.
Is Specwise MCP free?
Specwise MCP has a free plan, with paid plans for more usage or features.
How do I add Specwise MCP to Claude Code?
Run this command in your terminal: claude mcp add specwise-mcp --env RAPIDAPI_KEY='<RAPIDAPI_KEY>' --env API_MARKET_KEY='<API_MARKET_KEY>' -- uvx bytestay-specwise-mcp
What are the best alternatives to Specwise MCP?
The closest alternatives to Specwise MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Specwise MCP

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools