Skip to main content
Glama
Mhdd-24

API Contract MCP

by Mhdd-24
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript

@mhdd_24/api-contract-mcp

Validate API contracts between services.

Same architecture as @mhdd_24/sublime-mcp.

Full documentation: docs/WIKI.md

How it works (30 seconds)

You (chat) → MCP client → api-contract-mcp → API Contract APIs / CLIs / local tools

Related MCP server: OpenAPI Contracts MCP Server

Prerequisites

Requirement

Notes

Node.js 18+

ESM TypeScript MCP server

Credentials / CLIs

See environment variables below

Install

Option A — npm (after publish)

npm install -g @mhdd_24/api-contract-mcp

Option B — npx

npx @mhdd_24/api-contract-mcp

Option C — clone and build

git clone https://github.com/Mhdd-24/API-Contract-MCP.git
cd API-Contract-MCP
npm install
npm run build
node dist/index.js

Configure Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "apicontract": {
      "command": "npx",
      "args": ["-y", "@mhdd_24/api-contract-mcp"],
      "env": {
        "PROJECT_ROOT": "..."
      }
    }
  }
}

Local development:

{
  "command": "node",
  "args": ["/absolute/path/to/API-Contract-MCP/dist/index.js"]
}

Environment variables

Variable

Description

PROJECT_ROOT

Default project/repository root

Tools

Tool

Description

apicontract_status

Health check for API Contract MCP.

apicontract_validate

Validate a response against an expected schema/JSON.

apicontract_endpoints

List endpoints from OpenAPI JSON.

License

ISC

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors

Related MCP Servers