Skip to main content

MCP Server

Model Context Protocol (MCP) server for TimeCampus — a thin shell over @burdenoff/mcp-libs that exposes AI-assistant tools, resources, and prompts for the TimeCampus platform via GraphQL.

Quick start​

1. Install dependencies​

git clone https://github.com/algoshred/timecampus-mcp.git
cd timecampus-mcp
bun install

2. Configure in Claude Code​

Add to your project's .mcp.json (or ~/.claude/settings.json under mcpServers):

{
  "mcpServers": {
    "timecampus": {
      "type": "stdio",
      "command": "bun",
      "args": ["run", "~/products/timecampus/timecampus-mcp/src/index.ts"],
      "env": {
        "TIMECAMPUS_WORKSPACE_ENDPOINT": "https://graphqlworkspaces.burdenoff.com/workspaces/graphql",
        "TIMECAMPUS_GLOBAL_ENDPOINT": "https://graphql.burdenoff.com/global/graphql",
        "LOG_LEVEL": "error"
      }
    }
  }
}

3. Authenticate​

On first use, ask Claude to call timecampus_auth_login — it returns a verification URL and user code. Open the URL, enter the code, complete the login in the browser, then ask Claude to call timecampus_auth_complete. Tokens are persisted under ~/.config/timecampus-mcp/ (permissions 0o600) and auto-refresh before expiry.

Mounted modules​

The shell mounts the TimeCampus product module plus the shared platform modules from @burdenoff/mcp-libs:

auth, timecampus, sandbox, rbac, organizations, tours, workspaces, groups, tags, files, conversations, security, integrations, channels, scheduler, export, notifications, support, products, devportal, billing, store.

Tool / resource / prompt names are product-prefixed (timecampus_*).

Development​

bun install           # Install dependencies
bun run dev           # Dev server (stdio, hot reload)
bun run server:http   # HTTP transport mode
bun run test          # Run wiring tests (vitest)
bun run sanity        # typecheck + lint + format + build
bun run build         # Production build

Run as a binary after building:

node dist/index.js               # stdio transport
node dist/index.js --http --port 3030

Environment variables​

Defaults point at PROD. Override per environment via TIMECAMPUS_* env vars:

VariableDefaultDescription
TIMECAMPUS_WORKSPACE_ENDPOINThttps://graphqlworkspaces.burdenoff.com/workspaces/graphqlWorkspace gateway
TIMECAMPUS_GLOBAL_ENDPOINThttps://graphql.burdenoff.com/global/graphqlGlobal gateway
TIMECAMPUS_API_KEY—API key auth (skips device code)
TIMECAMPUS_ACCESS_TOKEN—Pre-set access token
TIMECAMPUS_WORKSPACE_ID—Pre-select workspace
TIMECAMPUS_ORGANIZATION_ID—Pre-select organization
LOG_LEVELinfoLogging level (error/warn/info/debug)

You can also use BURDENOFF_ENV=local to switch both endpoints at once.

Publishing​

Publishing is held (pre-launch). Pushing to main runs only the green gate (lint, typecheck, test, build). Publishing @timecampus/mcp to npmjs happens only via the manual release.yml workflow (workflow_dispatch or a v* tag).

Source​

Published as @timecampus/mcp on npm; source at github.com/algoshred/timecampus-mcp.

Next steps​