@typescape-ai/mcp

Typescape MCP Server - Model Context Protocol integration for AI agents like Claude.

Requirements

• Bun >= 1.0.0

Installation

bun add -D @typescape-ai/mcp

Usage with Claude Code

Add to your Claude Code MCP settings (~/.claude/mcp.json):

{
  "mcpServers": {
    "typescape": {
      "command": "bunx",
      "args": ["@typescape-ai/mcp"],
      "env": {
        "TYPESCAPE_API_KEY": "your-token-here",
        "TYPESCAPE_BASE_URL": "https://your-typescape-instance.vercel.app"
      }
    }
  }
}

Usage with Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "typescape": {
      "command": "bunx",
      "args": ["@typescape-ai/mcp"],
      "env": {
        "TYPESCAPE_API_KEY": "your-token-here",
        "TYPESCAPE_BASE_URL": "https://your-typescape-instance.vercel.app"
      }
    }
  }
}

Then reload MCP servers in Cursor (Cmd+Shift+P > "MCP: Reload").

Available Tools

typescape_create_session

Create a review session for a Markdown file.

| Parameter | Required | Description | | ----------------- | -------- | ------------------------------------- | | repo_id | Yes | Repository identifier | | git_sha | Yes | Concrete 40-hex Git commit SHA | | file_path | Yes | Path to Markdown file within the repo | | participants | Yes | Array of { email, roles } (min 1) | | title | No | Session title | | idempotency_key | No | Key for safe retries |

typescape_export_feedback

Export all feedback from a session as structured JSON (schema v1).

| Parameter | Required | Description | | ------------ | -------- | ----------------------------------- | | session_id | Yes | Session ID (e.g., sess_01HX...) | | schema | No | Export schema version (default: v1) |

Environment Variables

| Variable | Required | Description | | -------------------- | -------- | -------------------- | | TYPESCAPE_API_KEY | Yes | Operator API token | | TYPESCAPE_BASE_URL | Yes | Typescape server URL |

License

MIT