# 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](https://smithery.ai/server/@cerebralvalley/cv-mcp).
### With Claude Desktop
```bash
npx -y @smithery/cli install @cerebralvalley/cv-mcp --client claude
```
### With Cursor
```bash
npx -y @smithery/cli install @cerebralvalley/cv-mcp --client cursor
```
Or manually add to your `~/.cursor/mcp.json`:
```json
{
"mcpServers": {
"cerebralvalley": {
"url": "https://server.smithery.ai/@cerebralvalley/cv-mcp/mcp"
}
}
}
```
## Self-Hosted Installation
If you want to run the server locally:
### Installation
```bash
bun install
```
### Development
```bash
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`:
```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](https://bun.sh) — JavaScript runtime
- [MCP SDK](https://github.com/modelcontextprotocol/sdk) — Model Context Protocol
- [Zod](https://zod.dev) — Schema validation
