@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