MCP Server

HAPI MCP Server MCP Server

Name: HAPI MCP Server MCP Server
Author: ai.com.mcp

ai.com.mcp/hapi-mcp

Repository Registry

What is the HAPI MCP Server MCP server?

HAPI MCP server: Dynamically exposes OpenAPI REST APIs as MCP tools for AI assistants

How to install HAPI MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

HAPI_FQDN
Fully Qualified Domain Name for the HAPI server (used in MCP tool URLs)
HAPI_HOME
Directory path for HAPI configuration and specs. Should be mounted as a volume in Docker
PROJECT_NAME
The name of the project/API (alternative to positional argument)
HAPI_OPENAPI
OpenAPI spec URL or path (alternative to --openapi flag)
HAPI_URL
Backend API base URL (alternative to --url flag)
HAPI_PORT
Server port (alternative to --port flag) - this is the internal container port
HAPI_HEADLESS
Enable headless mode (alternative to --headless flag)
HAPI_MCP
Enable MCP mode (alternative to --mcp flag)
HAPI_DEV
Enable development mode (alternative to --dev flag)
HAPI_CORS
Comma-separated allowed CORS origins (alternative to --cors flag)
HAPI_CONFIG_FILES
Comma-separated configuration files (alternative to --filename flag)
NODE_ENV
Node environment (development, production). 'development' enables verbose logging and debugging features.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "hapi-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/hapimcp/hapi-cli:0.6.0",
        "-p",
        "-v",
        "serve",
        "petstore",
        "--port",
        "--headless",
        "--mcp",
        "--dev",
        "--url",
        "--openapi",
        "--cors",
        "--filename",
        "--cert",
        "--key"
      ],
      "env": {
        "HAPI_FQDN": "<YOUR_HAPI_FQDN>",
        "HAPI_HOME": "<YOUR_HAPI_HOME>",
        "PROJECT_NAME": "<YOUR_PROJECT_NAME>",
        "HAPI_OPENAPI": "<YOUR_HAPI_OPENAPI>",
        "HAPI_URL": "<YOUR_HAPI_URL>",
        "HAPI_PORT": "<YOUR_HAPI_PORT>",
        "HAPI_HEADLESS": "<YOUR_HAPI_HEADLESS>",
        "HAPI_MCP": "<YOUR_HAPI_MCP>",
        "HAPI_DEV": "<YOUR_HAPI_DEV>",
        "HAPI_CORS": "<YOUR_HAPI_CORS>",
        "HAPI_CONFIG_FILES": "<YOUR_HAPI_CONFIG_FILES>",
        "NODE_ENV": "<YOUR_NODE_ENV>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "hapi-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/hapimcp/hapi-cli:0.6.0",
        "-p",
        "-v",
        "serve",
        "petstore",
        "--port",
        "--headless",
        "--mcp",
        "--dev",
        "--url",
        "--openapi",
        "--cors",
        "--filename",
        "--cert",
        "--key"
      ],
      "env": {
        "HAPI_FQDN": "<YOUR_HAPI_FQDN>",
        "HAPI_HOME": "<YOUR_HAPI_HOME>",
        "PROJECT_NAME": "<YOUR_PROJECT_NAME>",
        "HAPI_OPENAPI": "<YOUR_HAPI_OPENAPI>",
        "HAPI_URL": "<YOUR_HAPI_URL>",
        "HAPI_PORT": "<YOUR_HAPI_PORT>",
        "HAPI_HEADLESS": "<YOUR_HAPI_HEADLESS>",
        "HAPI_MCP": "<YOUR_HAPI_MCP>",
        "HAPI_DEV": "<YOUR_HAPI_DEV>",
        "HAPI_CORS": "<YOUR_HAPI_CORS>",
        "HAPI_CONFIG_FILES": "<YOUR_HAPI_CONFIG_FILES>",
        "NODE_ENV": "<YOUR_NODE_ENV>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "hapi-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/hapimcp/hapi-cli:0.6.0",
        "-p",
        "-v",
        "serve",
        "petstore",
        "--port",
        "--headless",
        "--mcp",
        "--dev",
        "--url",
        "--openapi",
        "--cors",
        "--filename",
        "--cert",
        "--key"
      ],
      "env": {
        "HAPI_FQDN": "<YOUR_HAPI_FQDN>",
        "HAPI_HOME": "<YOUR_HAPI_HOME>",
        "PROJECT_NAME": "<YOUR_PROJECT_NAME>",
        "HAPI_OPENAPI": "<YOUR_HAPI_OPENAPI>",
        "HAPI_URL": "<YOUR_HAPI_URL>",
        "HAPI_PORT": "<YOUR_HAPI_PORT>",
        "HAPI_HEADLESS": "<YOUR_HAPI_HEADLESS>",
        "HAPI_MCP": "<YOUR_HAPI_MCP>",
        "HAPI_DEV": "<YOUR_HAPI_DEV>",
        "HAPI_CORS": "<YOUR_HAPI_CORS>",
        "HAPI_CONFIG_FILES": "<YOUR_HAPI_CONFIG_FILES>",
        "NODE_ENV": "<YOUR_NODE_ENV>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "hapi-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/hapimcp/hapi-cli:0.6.0",
        "-p",
        "-v",
        "serve",
        "petstore",
        "--port",
        "--headless",
        "--mcp",
        "--dev",
        "--url",
        "--openapi",
        "--cors",
        "--filename",
        "--cert",
        "--key"
      ],
      "env": {
        "HAPI_FQDN": "<YOUR_HAPI_FQDN>",
        "HAPI_HOME": "<YOUR_HAPI_HOME>",
        "PROJECT_NAME": "<YOUR_PROJECT_NAME>",
        "HAPI_OPENAPI": "<YOUR_HAPI_OPENAPI>",
        "HAPI_URL": "<YOUR_HAPI_URL>",
        "HAPI_PORT": "<YOUR_HAPI_PORT>",
        "HAPI_HEADLESS": "<YOUR_HAPI_HEADLESS>",
        "HAPI_MCP": "<YOUR_HAPI_MCP>",
        "HAPI_DEV": "<YOUR_HAPI_DEV>",
        "HAPI_CORS": "<YOUR_HAPI_CORS>",
        "HAPI_CONFIG_FILES": "<YOUR_HAPI_CONFIG_FILES>",
        "NODE_ENV": "<YOUR_NODE_ENV>"
      }
    }
  }
}

Claude Code

claude mcp add hapi-mcp --env HAPI_FQDN=<YOUR_HAPI_FQDN> --env HAPI_HOME=<YOUR_HAPI_HOME> --env PROJECT_NAME=<YOUR_PROJECT_NAME> --env HAPI_OPENAPI=<YOUR_HAPI_OPENAPI> --env HAPI_URL=<YOUR_HAPI_URL> --env HAPI_PORT=<YOUR_HAPI_PORT> --env HAPI_HEADLESS=<YOUR_HAPI_HEADLESS> --env HAPI_MCP=<YOUR_HAPI_MCP> --env HAPI_DEV=<YOUR_HAPI_DEV> --env HAPI_CORS=<YOUR_HAPI_CORS> --env HAPI_CONFIG_FILES=<YOUR_HAPI_CONFIG_FILES> --env NODE_ENV=<YOUR_NODE_ENV> -- docker run -i --rm docker.io/hapimcp/hapi-cli:0.6.0 -p -v serve petstore --port --headless --mcp --dev --url --openapi --cors --filename --cert --key

Related MCP servers

Agent Skills Search Server

Active

Search and discover Agent Skills — reusable AI agent capability packages — from the skills.sh registry.

21k

Python

Apache-2.0

View repository →

Contabo (VPS) MCP Server

Contabo API (v1.0.0) as MCP tools for cloud provisioning, and management. Powered by HAPI MCP server

View repository →

Lenny Rachitsky Podcast Transcripts MCP Server

MCP server for structured access to Lenny Rachitsky podcast transcripts. For content creators.

View repository →

LinkedIn MCP Server

LinkedIn API as MCP tools to retrieve profile data and publish content. Powered by HAPI MCP.

View repository →

OpenAI Tools MCP Server

Focused MCP server for OpenAI image/audio generation (v2.0.0). Wraps endpoints via HAPI CLI.

View repository →

Petstore MCP Server

Swagger Petstore API (v1.0.27) as MCP for testing and prototyping powered by the HAPI MCP server

View repository →