Skip to content
MCP server

Specwise MCP

Validate OpenAPI and JSON Schema and flag breaking changes between spec versions

Runs locallyStatus and history
Install
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-mcp

Add 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 key
  • API_MARKET_KEYYour api.market key, used when RAPIDAPI_KEY is not set
  • BYTESTAY_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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools