# @takehub/mcp

MCP (Model Context Protocol) server giving AI agents authenticated access to the
takehub API — topic create/manage, voting results, AI insights, and invites.

Published on npm as [`@takehub/mcp`](https://www.npmjs.com/package/@takehub/mcp).
No API key or config needed — you log in at runtime via the `authenticate` tool
(browser flow), so every install below works as-is.

## Install

**Claude Code** (one command, no config file):

```bash
claude mcp add takehub -- npx -y @takehub/mcp
# --scope user   → all your projects
# --scope project → shared, committed to .mcp.json for your team
```

**Claude Desktop** — install the one-click `.mcpb` bundle (see
[`mcpb/`](./mcpb)), or add this to `claude_desktop_config.json`
(`~/Library/Application Support/Claude/` on macOS,
`%APPDATA%\Claude\` on Windows):

```json
{
  "mcpServers": {
    "takehub": { "command": "npx", "args": ["-y", "@takehub/mcp"] }
  }
}
```

**Any other MCP client** — point it at `npx -y @takehub/mcp` (stdio).

## Build & run

```bash
# From repo root
npx turbo run build --filter=@takehub/mcp

# Offline smoke test (asserts the full tool surface boots over stdio)
cd packages/mcp && npm run smoke
```

By default the server talks to **production** (`api.takehub.app` /
`takehub.app`). Override with `VP_API_BASE_URL` / `VP_CLIENT_BASE_URL` to point
at a local or preview backend.

## Auth

Call the `authenticate` tool: it opens a browser to the takehub web app, you log
in, and tokens are POSTed back to a temporary localhost callback server. Tokens
are held **in memory for the life of the server process** — login and any
subsequent tool calls must happen against the same running process. See
`src/tools/auth.ts`.

## Root `.mcp.json` points at the local build (intentional)

The repo's `/.mcp.json` registers the `takehub` server as:

```json
{ "command": "node", "args": ["packages/mcp/dist/index.js"] }
```

rather than the published package (`npx @takehub/mcp`). This is **deliberate**:
in this monorepo we want the MCP server to reflect the code in the working tree
(including in-flight changes on a branch), not whatever version is published to
npm. The trade-off: you must run the build above before the server will start
(or after pulling changes), since it runs `dist/`, not source.

If you need the released package instead, temporarily switch the command back to
`npx @takehub/mcp`.