AsyncAPI MCP Server

An MCP (Model Context Protocol) server that gives AI assistants access to the AsyncAPI specification. Search, explore, and retrieve any version of the spec directly from your coding tool.

Features

• Search the AsyncAPI specification by keyword

• Retrieve specific sections by heading or slug

• List all stable spec versions available as GitHub tags

• Get metadata about the spec (version, source, cache info, size)

• Version-aware — query any released spec version, or default to the latest

• Caching — ETag/Last-Modified-based HTTP caching with a 10-minute TTL on tag lookups

Related MCP server: EasyPeasyMCP

Quick Start

Remote (Self-hosted on Render)

The recommended way to use this server is to deploy your own instance on Render — it's free (no credit card required). Add the following to your MCP client configuration:

{
  "mcpServers": {
    "asyncapi": {
      "url": "https://asyncapi-mcp.onrender.com/mcp"
    }
  }
}

See the Configuration section below for client-specific instructions, and the Deployment section for setup steps.

Local (Self-hosted)

Prerequisites

• Node.js v20 or later

Install

npm install

Build

npm run build

Run

Streamable HTTP (for local development):

npm run dev

The server starts on http://localhost:3000/mcp by default. Set the PORT environment variable to use a different port:

PORT=8080 npm run dev

Stdio (for local MCP clients):

npm run start:stdio

Available Tools

Available Resources

Configuration for AI Coding Tools

Remote (Render hosted)

Use these configs to connect to your self-hosted Render instance. Make sure you've deployed the server first.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "asyncapi": {
      "url": "https://asyncapi-mcp.onrender.com/mcp"
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "asyncapi": {
      "url": "https://asyncapi-mcp.onrender.com/mcp"
    }
  }
}

VS Code Copilot

Add to .vscode/mcp.json in your project root:

{
  "servers": {
    "asyncapi": {
      "url": "https://asyncapi-mcp.onrender.com/mcp",
      "type": "http"
    }
  }
}

Windsurf

Add to your Windsurf MCP settings:

{
  "mcpServers": {
    "asyncapi": {
      "url": "https://asyncapi-mcp.onrender.com/mcp"
    }
  }
}

Cline

In Cline's MCP settings, add:

{
  "mcpServers": {
    "asyncapi": {
      "url": "https://asyncapi-mcp.onrender.com/mcp"
    }
  }
}

OpenCode

Add to your OpenCode configuration:

{
  "mcp": {
    "servers": {
      "asyncapi": {
        "url": "https://asyncapi-mcp.onrender.com/mcp"
      }
    }
  }
}

Zed

Add to your Zed settings.json:

{
  "context_servers": {
    "asyncapi": {
      "url": "https://asyncapi-mcp.onrender.com/mcp"
    }
  }
}

Local (Self-hosted)

Use these configs when running the server locally with npm run dev. Make sure the server is running before connecting.

Claude Desktop

{
  "mcpServers": {
    "asyncapi": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Cursor

{
  "mcpServers": {
    "asyncapi": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

VS Code Copilot

{
  "servers": {
    "asyncapi": {
      "url": "http://localhost:3000/mcp",
      "type": "http"
    }
  }
}

Windsurf / Cline / OpenCode / Zed

Replace the Render URL in the configs above with http://localhost:3000/mcp.

Deployment

Render (Recommended — Free, easy setup)

Render provides a free web service tier with no credit card required. This is the easiest way to host your MCP server.

Free tier behavior

• 750 free instance hours per month — plenty for a single MCP server

• Sleeps after 15 minutes of idle time — the service spins down when nobody is using it

• Wakes up on next request — takes about 30–60 seconds to respond after sleep

• No credit card required — truly $0

Prerequisites

• A Render account

• Your code pushed to a public GitHub repository

Deploy via Git

1. In the Render dashboard, click New → Web Service.

2. Connect your GitHub account and select your repository.

3. Render will auto-detect the Node.js buildpack.

4. Set the following:

   • Name: asyncapi-mcp (or whatever you prefer)

   • Runtime: Node

   • Build Command: npm install && npm run build

   • Start Command: npm start

   • Instance Type: Free

5. Add environment variable:

   • PORT = 3000

6. Click Create Web Service.

Render will build and deploy your app. Once finished, you'll get a public URL like https://asyncapi-mcp.onrender.com.

Configure your MCP client

Your Render domain is already configured in the Configuration section above.

Health check

You can verify the server is running by visiting:

https://asyncapi-mcp.onrender.com/health

Self-hosted (Docker)

Build and run with the included Dockerfile:

docker build -t asyncapi-mcp .
docker run -p 3000:3000 asyncapi-mcp

The HTTP server will be available at http://localhost:3000/mcp.

Self-hosted (Local machine)

npm install
npm run build
npm start

The server starts on http://localhost:3000/mcp by default.

Usage Examples

Once configured, you can ask your AI assistant questions like:

• "What does the AsyncAPI spec say about server objects?"

• "Search the AsyncAPI spec for 'channels'"

• "Get the Info Object section from version 2.6.0"

• "List all available AsyncAPI spec versions"

• "What are the differences between messages in AsyncAPI 2.x and 3.x?"

• "Show me the spec section about schema definitions"

Development

# Install dependencies
npm install

# Build TypeScript to dist/
npm run build

# Run the HTTP server (local development)
npm run dev

# Run the stdio server (for local MCP clients)
npm run start:stdio

# Type-check without emitting
npx tsc --noEmit