Cerebral Valley MCP Server

Cerebral Valley provides tools for discovering and submitting AI community events, hackathons, and meetups.

Features

• search_events — Search events by city, type, date range, and free-text query
• submit_event — Submit a new event for review
• subscribe_to_newsletter — Subscribe an email to the CV newsletter

Quick Start (Hosted)

The easiest way to use this MCP server is via Smithery.

With Claude Desktop

npx -y @smithery/cli install @cerebralvalley/cv-mcp --client claude

With Cursor

npx -y @smithery/cli install @cerebralvalley/cv-mcp --client cursor

Or manually add to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "cerebralvalley": {
      "url": "https://server.smithery.ai/@cerebralvalley/cv-mcp/mcp"
    }
  }
}

Self-Hosted Installation

If you want to run the server locally:

Installation

bun install

Development

bun run dev        # stdio transport (for local MCP clients)
bun run dev:http   # HTTP transport (for testing Smithery deployment)

With Cursor (Local)

Add to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "cv-events": {
      "command": "bun",
      "args": ["run", "/path/to/cerebralvalley-events-mcp/src/server.ts"]
    }
  }
}

Then restart Cursor to load the MCP server.

Project Structure

src/
├── server.ts        # MCP server entry point (stdio transport)
├── http-server.ts   # MCP server for Smithery (HTTP transport)
├── api.ts           # API fetch functions
├── types.ts         # TypeScript types
├── constants.ts     # Shared constants (cities, event types, etc.)
└── tools/
    ├── index.ts               # Tool registration
    ├── searchEvents.ts        # Search events tool
    ├── submitEvent.ts         # Submit event tool
    └── subscribeNewsletter.ts # Newsletter subscription tool

API

The server connects to the Cerebral Valley public API:

• Base URL: https://api.cerebralvalley.ai/v1

Supported City Filters

• SF & Bay Area (default)
• New York City
• Boston
• Seattle
• London
• Remote
• Other

Event Types

• HACKATHON — Filter for hackathons only
• Omit for all event types

Tech Stack

• Bun — JavaScript runtime
• MCP SDK — Model Context Protocol
• Zod — Schema validation