BundleDex MCP Server

Agent-native discovery of OKF bundles via the Model Context Protocol

What Is This?

BundleDex exposes an MCP (Model Context Protocol) endpoint at bundledex.net/mcp that lets AI agents discover, search, and retrieve OKF bundles in real time. Instead of scraping a web page or parsing a JSON file, agents can use structured tool calls to find exactly what they need.

This endpoint follows the Model Context Protocol specification, making it compatible with Claude Code, Cursor, Windsurf, and any MCP-compatible agent.

How to Configure

Claude Code

Add the following to your ~/.claude/claude_desktop_config.json or Claude Code MCP configuration:

{
  "mcpServers": {
    "bundledex": {
      "type": "url",
      "url": "https://bundledex.net/mcp"
    }
  }
}

Then restart Claude Code. You can now use tools like search_bundles and get_bundle directly from your Claude Code session.

Cursor

In Cursor, add the MCP server in your project's .cursor/mcp.json:

{
  "mcpServers": {
    "bundledex": {
      "type": "url",
      "url": "https://bundledex.net/mcp"
    }
  }
}

Windsurf

In Windsurf, configure the MCP server in your project's .windsurf/mcp_config.json:

{
  "mcpServers": {
    "bundledex": {
      "type": "url",
      "url": "https://bundledex.net/mcp"
    }
  }
}

Generic MCP Client

For any MCP-compatible client, configure the server endpoint:

{
  "mcpServers": {
    "bundledex": {
      "url": "https://bundledex.net/mcp"
    }
  }
}

Example Usage

Initialize

Every MCP session starts with an initialize request:

// Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "clientInfo": { "name": "my-agent", "version": "1.0.0" }
  }
}

List Available Tools

// Request
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list"
}

Search Bundles

// Request
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "search_bundles",
    "arguments": { "query": "knowledge-graph" }
  }
}

Get Bundle Details

// Request
{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "get_bundle",
    "arguments": { "slug": "iwe" }
  }
}

List Categories

// Request
{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "list_categories",
    "arguments": {}
  }
}

Get Stats

// Request
{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": {
    "name": "get_stats",
    "arguments": {}
  }
}

Tool Reference

Tool Description Parameters
search_bundles Full-text search across all OKF bundles query (string, required), limit (number, optional)
get_bundle Get details for a specific bundle by slug slug (string, required)
list_categories List all bundle categories with counts None
get_stats Get BundleDex traffic statistics None

API Endpoint

The MCP server is available at:

POST https://bundledex.net/mcp
Content-Type: application/json

All requests must be valid JSON-RPC 2.0 messages. The endpoint supports CORS for browser-based clients.

Related Resources