MCP.so
Sign In

APILinter MCP Server

@jbovet

Repository

About APILinter MCP Server

The OpenAPI MCP Server powers seamless communication using agents and REST APIs by implementing the Model Context Protocol

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "api-linter": {
      "command": "docker-compose",
      "args": [
        "-f",
        "/path/to/your/project/docker-compose.yml",
        "up",
        "mcp-server",
        "--build"
      ],
      "cwd": "/path/to/your/project",
      "env": {
        "APILINTER_URL": "http://localhost:8000"
      }
    }
  }
}

Tools

4

Validates an API specification (OpenAPI/Swagger) against API Linter rules

Lists all available API Linter rules

Calculates the quality score of an API specification

Retrieves the categories of API Linter rules

Overview

What is APILinter MCP Server?

APILinter MCP Server enables seamless communication between LLMs and REST APIs by implementing the Model Context Protocol (MCP). It integrates with the Zally API Linter to validate and analyze OpenAPI/Swagger specifications, providing tools for linting, quality scoring, and design review.

How to use APILinter MCP Server?

Clone the repository, install dependencies with npm install, and build with npm run build. Configure environment variables (e.g., PORT, APILINTER_URL), run Zally server separately, then start the MCP server with npm run dev. Use the provided tools (validate_api_specification, list_rules, etc.) and prompts (api_design_review) via an MCP client or the included example interactive client (npx tsx example/simpleStreamableHttp.ts).

Key features of APILinter MCP Server

  • Implements MCP Streamable HTTP transport (stateless)
  • Provides five tools for API linting and quality scoring
  • Includes pre-configured api_design_review prompt
  • Supports retry logic and circuit breaker patterns
  • Structured logging, metrics, health checks, and error handling
  • Input validation and origin validation for security

Use cases of APILinter MCP Server

  • Validate an API specification against Zally linting rules
  • List available linting rules filtered by active status
  • Calculate a quality score for an OpenAPI specification
  • Retrieve rule categories from the API linter
  • Obtain structured design feedback on an API specification

FAQ from APILinter MCP Server

What runtime dependencies does it require?

It requires Node.js, npm, and a running Zally server (see Zally’s quick start guide).

How does it handle service failures?

It implements retry logic (configurable via RETRY_COUNT) and a circuit breaker (threshold configurable via CIRCUIT_BREAKER_THRESHOLD) to gracefully handle transient failures.

What transport protocols are supported?

Only MCP Streamable HTTP transport is implemented. SSE and STDIO transports are not planned.

Where does API specification data live?

Data is sent to the API linter service (configured via APILINTER_URL) for validation; the server itself is stateless and does not persist specification content.

Is authentication supported?

MCP authentication is not implemented, as the README states it is "not necessary". Origin validation (localhost only in development) is used for security.

Frequently asked questions

What runtime dependencies does it require?

It requires Node.js, npm, and a running Zally server (see Zally’s quick start guide).

How does it handle service failures?

It implements retry logic (configurable via `RETRY_COUNT`) and a circuit breaker (threshold configurable via `CIRCUIT_BREAKER_THRESHOLD`) to gracefully handle transient failures.

What transport protocols are supported?

Only MCP Streamable HTTP transport is implemented. SSE and STDIO transports are not planned.

Where does API specification data live?

Data is sent to the API linter service (configured via `APILINTER_URL`) for validation; the server itself is stateless and does not persist specification content.

Is authentication supported?

MCP authentication is not implemented, as the README states it is "not necessary". Origin validation (localhost only in development) is used for security.

Comments

Basic information

Category

Other

License

MIT license

Transports

stdio

Author

jbovet

Submitted by

Jose Bovet Derpich

More Other MCP servers

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K