Advertise
MCP.so
Sign In

APILinter MCP Server

@jbovet

Repository

Basic information

Category

Other

License

MIT license

Transports

stdio

Author

jbovet

Submitted by

Jose Bovet Derpich

About APILinter MCP Server

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

APILinter MCP Server 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"
      }
    }
  }
}

APILinter MCP Server 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

Frequently asked questions

1

What runtime dependencies does it require?

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

2

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.

3

What transport protocols are supported?

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

4

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.

5

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

More Other MCP servers

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Advertise