@typescape-ai/mcp

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

The published package exposes a broad multi-family tool registry for review, finding, workflow, rules, governance-signal, 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.3.10
• 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

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": "bunx",
      "args": ["@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_supersede_review
6. typescape_export_review

typescape_supersede_review is the generic content-review revision flow. Rules working drafts use typescape_revise_rules.

Rules workflow:

1. typescape_get_rules
2. typescape_list_rule_documents
3. typescape_check_content
4. typescape_import_rules
5. typescape_revise_rules
6. typescape_publish_rules
7. typescape_create_release_candidate
8. typescape_transition_release_candidate

Supplemental diagnostics:

• 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_supersede_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_list_rule_documents
• typescape_check_content
• typescape_import_rules
• typescape_revise_rules
• typescape_publish_rules
• typescape_deprecate_rules
• typescape_create_release_candidate
• typescape_list_release_candidates
• typescape_get_release_candidate
• typescape_get_release_candidate_status
• typescape_transition_release_candidate
• 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.
• The server publishes a compact typescape://workspace/summary resource for ambient tool discovery and workspace context.

Response Shape

Every MCP tool returns compact JSON text in content[0].text. The tool-call layer stays JSON for compatibility, while the workspace summary resource is optimized for agent bootstrap 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

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

License

MIT