BeachHouse MCP Server

The context layer for your organization - delivered to Claude Code and Cursor via Model Context Protocol (MCP).

BeachHouse unifies context from GitHub, Linear, Slack, and Notion. This MCP server makes that context available to AI coding assistants.

Installation

Claude Code

claude mcp add --transport stdio beachhouse -- npx @beachhouse/mcp

Cursor

Add to your .cursor/mcp.json (project-level) or Cursor settings:

{
  "mcpServers": {
    "beachhouse": {
      "command": "npx",
      "args": ["@beachhouse/mcp"],
      "env": {
        "BEACHHOUSE_API_URL": "https://your-beachhouse.example.com",
        "BEACHHOUSE_API_TOKEN": "your-api-token"
      }
    }
  }
}

Configuration

The MCP server requires two environment variables:

| Variable | Description | |----------|-------------| | BEACHHOUSE_API_URL | Your BeachHouse server URL (e.g., https://beachhouse.example.com) | | BEACHHOUSE_API_TOKEN | API token from BeachHouse dashboard (Profile → API Tokens) |

Available Tools

beachhouse_get_context

Get development and business context for a file path.

> What context is relevant to src/auth/login.ts?

Returns related issues, PRs, discussions, PRDs, and strategy docs from GitHub, Linear, Slack, and Notion.

beachhouse_search

Search across all connected tools using semantic search.

> Search for "user authentication flow"

Finds PRDs, issues, discussions, and documents by meaning, not just keywords.

beachhouse_list_entities

List entities (people, projects, issues, repositories) from connected tools.

> List all users from GitHub
> Show me recent issues

beachhouse_get_entity

Get detailed information about a specific entity.

> Get details for entity 42

beachhouse_list_issues

List recent issues from connected issue trackers.

> What issues are open in Linear?
> Show me GitHub issues

Example Usage

In Claude Code or Cursor, you can ask natural questions:

• "What issues are related to the payment system?"
• "Find the PRD for user authentication"
• "Who worked on the checkout feature?"
• "What's the context for this file?"

The AI will automatically use the appropriate BeachHouse tools to find answers.

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

# Run the built server
npm start

Troubleshooting

"BEACHHOUSE_API_URL environment variable is required"

Set the environment variable to your BeachHouse server URL:

export BEACHHOUSE_API_URL=https://your-beachhouse.example.com

"BEACHHOUSE_API_TOKEN environment variable is required"

1. Log into your BeachHouse dashboard
2. Go to Profile → API Tokens
3. Generate a new token
4. Set the environment variable:

export BEACHHOUSE_API_TOKEN=your-token-here

"Invalid API token"

Your token may have expired or been revoked. Generate a new one from the BeachHouse dashboard.

Connection errors

Ensure your BeachHouse server is running and accessible from your machine.

Also Available

BeachHouse context is also available via:

• BeachHouse for VS Code - Sidebar extension for browsing context
• API - REST API for custom integrations

License

MIT