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