@typescape-ai/mcp

Typescape MCP server for external agent harnesses that need canonical review, finding, decision, rules, corpus, and export workflows.

The published package exposes a broad multi-family tool registry for review, finding, workflow, rules, advisory, project, issue, and repository operations. MCP is the easiest discovery surface for agent clients such as Claude Code, Cursor, and Windsurf, but it is not the whole product surface. Typescape also ships the same operating model over the API and CLI.

Requirements

• Bun >=1.0 is preferred
• Node.js >=18.17 also works for npx-style launchers
• TYPESCAPE_API_KEY and TYPESCAPE_BASE_URL

Install

Preferred ephemeral launch:

bunx @typescape-ai/mcp

If you want to pin the package in a repo:

bun add -D @typescape-ai/mcp

Node-based MCP clients can also launch it without installing Bun:

npx -y @typescape-ai/mcp

Client Config

Generic MCP config shape:

{
  "mcpServers": {
    "typescape": {
      "command": "bunx",
      "args": ["@typescape-ai/mcp"],
      "env": {
        "TYPESCAPE_API_KEY": "ts_op_your_token",
        "TYPESCAPE_BASE_URL": "https://your-typescape-instance.example.com"
      }
    }
  }
}

Claude Code example: ~/.claude/mcp.json

{
  "mcpServers": {
    "typescape": {
      "command": "bunx",
      "args": ["@typescape-ai/mcp"],
      "env": {
        "TYPESCAPE_API_KEY": "ts_op_your_token",
        "TYPESCAPE_BASE_URL": "https://your-typescape-instance.example.com"
      }
    }
  }
}

Cursor example: .cursor/mcp.json

{
  "mcpServers": {
    "typescape": {
      "command": "npx",
      "args": ["-y", "@typescape-ai/mcp"],
      "env": {
        "TYPESCAPE_API_KEY": "ts_op_your_token",
        "TYPESCAPE_BASE_URL": "https://your-typescape-instance.example.com"
      }
    }
  }
}

Canonical Workflows

Review workflow:

1. typescape_create_review
2. typescape_get_render
3. typescape_create_finding
4. typescape_post_comment / typescape_record_decision
5. typescape_export_review

Rules workflow:

1. typescape_get_rules
2. typescape_check_content
3. typescape_import_rules
4. typescape_rules_dashboard

API/CLI parity:

• API is the canonical automation contract. See ../../docs/api.md.
• CLI is the first-class terminal surface for the same review and rules workflows. See ../cli/README.md.
• MCP is the adapter/discovery surface for agent clients that already speak MCP.

Tool Families

Reviews:

• typescape_create_review
• typescape_revise_review
• typescape_export_review
• typescape_list_reviews
• typescape_get_review
• typescape_get_render
• typescape_search_reviews
• typescape_close_review
• typescape_reopen_review
• typescape_export_response_matrix

Findings, comments, decisions, and evidence:

• typescape_list_findings
• typescape_search_findings
• typescape_create_finding
• typescape_post_comment
• typescape_resolve_finding
• typescape_reopen_finding
• typescape_record_decision
• typescape_attach_evidence
• typescape_get_decision
• typescape_list_evidence

Review sets and refs:

• typescape_create_review_set
• typescape_export_review_set
• typescape_create_review_ref
• typescape_resolve_review_ref
• typescape_advance_review_ref

Approvals, checks, account, and capabilities:

• typescape_request_approval
• typescape_get_status
• typescape_run_checks
• typescape_account_usage
• typescape_account_plan
• typescape_get_capabilities

Corpus:

• typescape_get_snapshot
• typescape_list_backlinks
• typescape_get_impact

Rules:

• typescape_get_rules
• typescape_rules_pack (compatibility-only)
• typescape_check_content
• typescape_import_rules
• typescape_rules_dashboard

Repo, asset, and collection support:

• typescape_list_repos
• typescape_connect_repo
• typescape_repo_branches
• typescape_upload_reviewer_asset
• typescape_create_collection
• typescape_add_review_to_collection

Notes

• Feature-gated tools return feature_disabled when the backing capability is off for the tenant.

Response Shape

Every MCP tool returns JSON text in content[0].text.

Success example:

{
  "content": [
    {
      "type": "text",
      "text": "{\"review_id\":\"sess_01HX...\",\"request_id\":\"req_abc123\"}"
    }
  ]
}

Error example:

{
  "error": {
    "code": "review_not_found",
    "message": "No review with that ID exists.",
    "retryable": false,
    "request_id": "req_abc123"
  }
}

Environment

License

MIT