Cerebral Valley

Cerebral Valley MCP Server provides a lightweight interface for discovering and submitting AI community events, hackathons, and meetups. It exposes tools to search events, submit new events for review, and subscribe audiences to the CV newsletter, making it easier for MCP clients to integrate event data into their workflows.

How to use

You connect to the Cerebral Valley MCP Server from an MCP client. You can use the remote HTTP endpoint to interact with the server, or run a local stdio-based server for development and testing. The server exposes these core tools: search_events to find events by city, type, date range, and text query; submit_event to submit a new event for review; and subscribe_to_newsletter to add an email to the CV newsletter.

How to install

Prerequisites: you need a JavaScript runtime. You can run a hosted instance or self-host locally with Bun.

Hosted quick start with a client (recommended for most users): install the MCP client through the Smithery workflow.

With Claude Desktop client, run the following command to install the CV MCP client via npx:

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

With Cursor client, install the CV MCP client via npx:

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

Or, manually add the HTTP MCP endpoint to your Cursor configuration so the client can talk to the remote server. Create or update your Cursor MCP configuration file at ~/.cursor/mcp.json with this structure (the URL points to the remote MCP server):

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

Self-Hosted Installation

If you want to run the server locally, you can build and run it with Bun.

Installation steps to set up a local development environment:

bun install

Development servers you can run locally for testing transport layers:

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

If you run the server locally with Cursor, add the following to your Cursor configuration to point to the local MCP server entry point. Replace the path with the actual location of your local server file.

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

Project structure and APIs

The project is organized to separate the server, HTTP transport, and tool implementations. The server exposes tools for searching events, submitting events, and subscribing newsletters through clearly defined API surfaces and transport layers.

Additional notes

If you are testing locally, ensure you restart Cursor after adding a new MCP server configuration so the client loads the latest server definitions.

Available tools

search_events

Search events by city, type, date range, and free-text query.

submit_event

Submit a new event for review by Cerebral Valley.

subscribeNewsletter

Subscribe an email to the CV newsletter.