SKILLKnowledge Workproductivity

carta-download-tearsheet

プラグイン: carta-investors
ソース: GitHub で見る ↗

説明

Cartaであなたのポートフォリオ企業やファンドのティアシート（投資対象企業の概要資料）をダウンロードできます。ティアシートのリクエスト（申し込み）については、carta-lp-reporting-routingをご利用ください。

原文を表示

Download tear sheets for your portfolio companies and funds on Carta. For tear sheet requests, use carta-lp-reporting-routing instead.

ユースケース

ポートフォリオ企業のティアシートをダウンロードしたいとき
ファンドのティアシートをダウンロードしたいとき
投資対象企業の概要資料を取得したいとき

本文（日本語訳）

ティアシート（企業概要資料）をダウンロード

概要

Cartaのポートフォリオ企業およびファンドのティアシートをダウンロードします。

このスキルはテンプレートとポートフォリオ企業を対話的に表示した後、選択内容に基づいて適切なワークフローに振り分けます：

全ファンドの全ポートフォリオ企業 → 全体ダウンロード：ファンド別の分類が不要な高速処理
特定のポートフォリオ企業（1社以上） → 一括ダウンロード：ファンド別の分類を作成し、非同期でZIPファイルを生成。完成までポーリング（定期確認）し、ダウンロードURLを提供

使用するとき

次のような場合に使用：

「[企業名]のティアシートを作成して」
「[企業名]のティアシートを生成して」
「全ポートフォリオ企業のティアシートをダウンロードして」
「一括ティアシートパッケージを作成して」
「[企業名]のティアシートをプレビューして」
「[ファンド名]の全企業のティアシートを生成して」
「全ティアシートをZIPでダウンロードして」
その他：「ティアシート」「企業概要資料」「PDFで生成」「パッケージダウンロード」など

前提条件

Carta MCPサーバーが接続されていること
アクティブなファーム（企業集団）コンテキストが存在すること。設定されていない場合は、他の操作の前に list_contexts を実行してから set_context でターゲットの firm_id を設定してください
ファンドUUIDやポートフォリオ企業UUIDを事前に知っている必要はありません。どちらも fa:list:tearsheet_templates と fa:list:portfolio_companies で対話的に解決されます

データ取得

MCPコマンド	目的
`call_tool({"name": "fa__list__tearsheet_templates", "arguments": {}})`	企業で利用可能なPDFテンプレートの一覧
`call_tool({"name": "fa__list__portfolio_companies", "arguments": {}})`	全ポートフォリオ企業をファンド分類付きで一覧表示
`call_tool({"name": "fa__mutate__download_all_tearsheets", "arguments": {...}})`	全企業の非同期一括ダウンロードジョブを開始（高速処理）
`call_tool({"name": "fa__mutate__start_tearsheet_download", "arguments": {...}})`	特定企業の非同期一括ダウンロードジョブを開始
`call_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}})`	非同期ジョブの完了状態をポーリング。`"pending"` またはダウンロードURLを返す

ステップ0：ファームコンテキストの確認

アクティブなファームコンテキストが存在することを確認してください。セッション開始時の最初のMCP呼び出し、またはそれ以降の呼び出しでファーム・コンテキストエラーが発生した場合：

list_contexts を実行してアクセス可能なファームを確認
set_context でターゲットの firm_id を指定

ユーザーにファームUUIDを尋ねる必要はありません。MCPセッションがアクティブなファームを追跡しています。

ステップ1：テンプレートを選択

実行：

call_tool({"name": "fa__list__tearsheet_templates", "arguments": {}})

ユーザーがドキュメント名を指定した場合（例：「投資サマリー」「ファンドサマリー」「ティアシート」）：テンプレートの name フィールドと一致させます（大文字小文字を区別しない、部分一致）。

一致するテンプレートが見つかった場合： ユーザーに確認

「テンプレート『投資サマリー』が見つかりました — これでよろしいですか？」

「はい」なら保存して進みます。「いいえ」なら全テンプレート表を表示します。
一致するテンプレートが見つからない場合： ユーザーに通知してから全テンプレート表を表示

「このファームに『投資サマリー』という名前のテンプレートは見つかりません。利用可能なテンプレートは以下の通りです — どちらを使いますか？」

ドキュメント名が指定されていない場合：

テンプレートが1つ： 進む前にユーザーに確認

テンプレートが複数： 表を表示し、ユーザーに番号で選択させます

| # | id | 名前 | 向き | 粒度（情報の詳細レベル） | 説明 |
|---|----|------|------|-------------|------|
| 1 | aaa-... | Q4 2024標準版 | 横向き | ファンド | — |
| 2 | bbb-... | 年次サマリー   | 縦向き  | 企業 | 年間LP報告書 |

TEMPLATE_UUID（テンプレートの id）と TEMPLATE_NAME として保存します。

ステップ2：ポートフォリオ企業を選択

実行：

call_tool({"name": "fa__list__portfolio_companies", "arguments": {}})

このコマンドはポートフォリオ企業の配列を返します。各項目は name、entity_link_id、fund_uuid を含みます。

fund_uuid でグループ化し、番号付き表を表示：

## Acmeファンド I
| # | 企業名 | entity_link_id | fund_uuid |
|---|--------|----------------|-----------|
| 1 | Alpha企業 | el-uuid-1      | fund-uuid-1 |
| 2 | Beta企業  | el-uuid-2      | fund-uuid-1 |

## Acmeファンド II
| # | 企業名 | entity_link_id | fund_uuid |
|---|--------|----------------|-----------|
| 3 | Gamma企業 | el-uuid-3      | fund-uuid-2 |

ユーザーに選択肢を示します：

全ファンドの全企業
特定ファンドの全企業
特定の企業 — 行番号または entity_link_id で指定

ステップ3：ルーティング

ユーザーがポートフォリオ企業を選択した後：

全ファンドの全企業が選択された → 全体ダウンロード処理に進む
1社以上の特定企業が選択された → FUND_BREAKDOWNS を構築して一括ダウンロード処理に進む

全体ダウンロード処理（全企業）

開始前に確認サマリーを表示 — ユーザーの明確な承認なしに進まない：

全ポートフォリオ企業のティアシートを生成する準備ができました：

  テンプレート：<TEMPLATE_NAME> (<TEMPLATE_UUID>)
  範囲：全ファンドの全企業

進みますか？（はい/いいえ）

全体ダウンロードコマンドでバッチジョブを開始：

call_tool({"name": "fa__mutate__download_all_tearsheets", "arguments": {
  "template_uuid": "<TEMPLATE_UUID>"
}})

ユーザーにジョブが開始され、ポーリングが開始されることを告知します。

完了までポーリング — call_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}}) を30秒間隔で最大10回（合計5分）実行：

レスポンスが "pending" → 進捗を表示（「処理中... （N/10回目）」）して待機
レスポンスがURLを含む → ジョブ完了。DOWNLOAD_URL として取得
レスポンスがエラーメッセージ → エラーを表示して停止

タイムアウト（10回実行完了）： ユーザーにジョブが実行中の可能性があることを告知し、「ティアシートダウンロード状態を確認して」と尋ねるよう案内します。

成功時： ダウンロードリンクを表示：

成果物を直接ダウンロードしない。常にダウンロードリンクを提示してください。

ティアシートの準備ができました！

[ティアシートをダウンロード](<DOWNLOAD_URL>)

> 注意：このリンクは一時的で有効期限があります。すぐにダウンロードしてください。

一括ダウンロード処理（複数企業）

FUND_BREAKDOWNS を構築 — entity_link_id を fund_uuid でグループ化：

[
  {"fund_uuid": "fund-uuid-1", "entity_link_ids": ["el-uuid-1", "el-uuid-2"]},
  {"fund_uuid": "fund-uuid-2", "entity_link_ids": ["el-uuid-3"]}
]

開始前に確認サマリーを表示 — ユーザーの明確な承認なしに進まない：

一括ティアシートを生成する準備ができました：

  テンプレート：Q4 2024標準版 (aaa-...)
  企業数：2ファンド中3社

    Acmeファンド I
      - Alpha企業
      - Beta企業
    Acmeファンド II
      - Gamma企業

進みますか？（はい/いいえ）

バッチジョブを開始：

call_tool({"name": "fa__mutate__start_tearsheet_download", "arguments": {
  "template_uuid": "<TEMPLATE_UUID>",
  "fund_breakdowns": <FUND_BREAKDOWNS>
}})

ユーザーにジョブが開始され、ポーリングが開始されることを告知します。

完了までポーリング — call_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}}) を15秒間隔で最大20回（合計5分）実行：

レスポンスが "pending" → 進捗を表示（「処理中... （N/20回目）」）して待機
レスポンスがURLを含む → ジョブ完了。DOWNLOAD_URL として取得
レスポンスがエラーメッセージ → エラーを表示して停止

タイムアウト（20回実行完了）： ユーザーにジョブが実行中の可能性があることを告知し、「ティアシートダウンロード状態を確認して」と尋ねるよう案内します。

成功時： ダウンロードリンクを表示：

成果物を直接ダウンロードしない。常にダウンロードリンクを提示してください。

ティアシートの準備ができました！

[ティアシートをダウンロード](<DOWNLOAD_URL>)

> 注意：このリンクは一時的で有効期限があります。すぐにダウンロードしてください。

エラーハンドリング

ファームコンテキストエラー： list_contexts と set_context を実行してコンテキストを再確立
テンプレートが返されない場合： ファームがティアシートテンプレートを設定していない可能性があります。Cartaアプリで確認するか、サポートに連絡してください
ポートフォリオ企業が返されない場合： ファームにポートフォリオ企業がない可能性があります。正しいファームコンテキストがアクティブであることを確認してください
一括ジョブが失敗した場合： テンプレートまたはポートフォリオ企業の選択が無効な可能性があります。別の選択を試してください
自動的に再試行しない — 完全なエラー内容を表示し、ユーザーに判断させてください

原文（English）を表示

<carta-plugin>carta-investors:6.38.0</carta-plugin>

Download Tearsheet

Overview

Download tear sheets for your portfolio companies and funds on Carta.

The skill presents available templates and portfolio companies interactively, then routes to the appropriate workflow based on the selection:

All portcos across all funds → Download All: fast path — no fund breakdown needed.
Specific portcos (one or more) → Bulk: builds fund breakdowns, async ZIP archive, polled until complete, download URL provided.

When to Use

"Create a [Portco] tear sheet"
"Generate a tear sheet for [Portco]"
"Download tear sheet for all portfolio companies"
"Create a bulk tear sheet package"
"Preview the tear sheet for [Portco]"
"Generate tear sheets for all portcos in [Fund]"
"Download all tear sheets as a ZIP"
Other trigger phrases: "tear sheet for portco", "tear sheets for all portcos", "preview tear sheet", "generate tear sheet PDF", "create tear sheet", "download tear sheet package", "download all tear sheets".

Prerequisites

The Carta MCP server must be connected.
A firm context must be active. If not set, call list_contexts then set_context with the target firm_id before any other call.
No fund UUID or portco UUID needs to be known in advance — both are resolved interactively via fa:list:tearsheet_templates and fa:list:portfolio_companies.

Data Retrieval

MCP Command	Purpose
`call_tool({"name": "fa__list__tearsheet_templates", "arguments": {}})`	List available PDF templates for the firm
`call_tool({"name": "fa__list__portfolio_companies", "arguments": {}})`	List all portfolio companies with their fund groupings
`call_tool({"name": "fa__mutate__download_all_tearsheets", "arguments": {...}})`	Start an async job for all portcos (fast path)
`call_tool({"name": "fa__mutate__start_tearsheet_download", "arguments": {...}})`	Start an async bulk job for a specific portco subset
`call_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}})`	Poll for async job completion; returns `"pending"` or a download URL

Gate 0: Firm Context

Ensure a firm context is active. If this is your first MCP call in the session, or if subsequent calls fail with a firm/context error:

Call list_contexts to see which firms are accessible.
Call set_context with the target firm_id.

You do not need to ask the user for a firm UUID — the MCP session tracks the active firm.

Gate 1: Select Template

Call:

call_tool({"name": "fa__list__tearsheet_templates", "arguments": {}})

If the user mentioned a document name (e.g. "Investment Summary", "Fund Summary", "Tear Sheet"): match it against the template name field (case-insensitive, partial match).

Match found: Confirm with the user:

"Found template 'Investment Summary' — is this the one you want?"

If yes, store it and continue. If no, show the full table.
No match found: Tell the user, then show the full table:

"No template named 'Investment Summary' was found for this firm. Here are the available templates — which one would you like to use?"

If no document name was mentioned:

One template: Confirm with user before proceeding.

Multiple templates: Show table, ask user to select by number:

| # | id | Name | Orientation | Grain Level | Description |
|---|----|------|-------------|-------------|-------------|
| 1 | aaa-... | Q4 2024 Standard | landscape | fund | — |
| 2 | bbb-... | Annual Summary   | portrait  | company | Annual LP report |

Store as TEMPLATE_UUID (the template id) and TEMPLATE_NAME.

Gate 2: Select Portfolio Companies

Call:

call_tool({"name": "fa__list__portfolio_companies", "arguments": {}})

The command returns an array of portfolio companies. Each item includes name, entity_link_id, and fund_uuid.

Group them by fund_uuid and display a numbered table:

## Acme Fund I
| # | Company Name | entity_link_id | fund_uuid |
|---|--------------|----------------|-----------|
| 1 | Portco Alpha | el-uuid-1      | fund-uuid-1 |
| 2 | Portco Beta  | el-uuid-2      | fund-uuid-1 |

## Acme Fund II
| # | Company Name | entity_link_id | fund_uuid |
|---|--------------|----------------|-----------|
| 3 | Portco Gamma | el-uuid-3      | fund-uuid-2 |

Ask the user to choose:

All portcos across all funds
All portcos in a specific fund
Specific companies — by row number or entity_link_id

Gate 3: Route

After the user selects portcos:

All portcos across all funds selected → proceed to Download All Flow.
One or more specific portcos selected → build FUND_BREAKDOWNS and proceed to Bulk Flow.

Download All Flow (all portcos)

Present a confirmation summary before starting — never proceed without explicit user approval:

Ready to generate tearsheets for all portfolio companies:

  Template:  <TEMPLATE_NAME> (<TEMPLATE_UUID>)
  Scope:     All portcos across all funds

Proceed? (yes/no)

Start the bulk job using the download-all command:

call_tool({"name": "fa__mutate__download_all_tearsheets", "arguments": {
  "template_uuid": "<TEMPLATE_UUID>"
}})

Tell the user the job has started and polling will begin.

Poll for completion — call call_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}}) every 30 seconds, up to 10 attempts (5 minutes total):

Response is "pending" → print progress ("Still processing... (attempt N/10)") and wait.
Response contains a URL → job complete. Capture as DOWNLOAD_URL.
Response is an error message → surface it and stop.

On timeout (10 attempts exhausted): Tell the user the job may still be running and they can check manually by asking: "Check tearsheet download status".

On success: Present the download link:

DO NOT try to download the artifact directly. ALWAYS present the download link.

Your tear sheets are ready!

[Download Your Tear Sheets](<DOWNLOAD_URL>)

> Note: this link is temporary and will expire — download it soon.

Bulk Flow (multiple portcos)

Build FUND_BREAKDOWNS — group entity_link_ids by fund_uuid:

[
  {"fund_uuid": "fund-uuid-1", "entity_link_ids": ["el-uuid-1", "el-uuid-2"]},
  {"fund_uuid": "fund-uuid-2", "entity_link_ids": ["el-uuid-3"]}
]

Present a confirmation summary before starting — never proceed without explicit user approval:

Ready to generate bulk tearsheets:

  Template:  Q4 2024 Standard (aaa-...)
  Portcos:   3 companies across 2 funds

    Acme Fund I
      - Portco Alpha
      - Portco Beta
    Acme Fund II
      - Portco Gamma

Proceed? (yes/no)

Start the bulk job:

call_tool({"name": "fa__mutate__start_tearsheet_download", "arguments": {
  "template_uuid": "<TEMPLATE_UUID>",
  "fund_breakdowns": <FUND_BREAKDOWNS>
}})

Tell the user the job has started and polling will begin.

Poll for completion — call call_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}}) every 15 seconds, up to 20 attempts (5 minutes total):

Response is "pending" → print progress ("Still processing... (attempt N/20)") and wait.
Response contains a URL → job complete. Capture as DOWNLOAD_URL.
Response is an error message → surface it and stop.

On timeout (20 attempts exhausted): Tell the user the job may still be running and they can check manually by asking: "Check tearsheet download status".

On success: Present the download link:

DO NOT try to download the artifact directly. ALWAYS present the download link.

Your tear sheets are ready!

[Download Your Tear Sheets](<DOWNLOAD_URL>)

> Note: this link is temporary and will expire — download it soon.

Error Handling

Firm context error: Call list_contexts and set_context to re-establish context.
No templates returned: The firm may not have tearsheet templates configured. Check the Carta app or contact support.
No portcos returned: The firm may not have portfolio companies. Verify the correct firm context is active.
Bulk job failure: Template or portco selection may be invalid. Retry with different selections.
Never retry automatically — surface the full error and let the user decide.

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。

SKILLKnowledge Workproductivity

carta-download-tearsheet

プラグイン: carta-investors
ソース: GitHub で見る ↗

説明

原文を表示

Download tear sheets for your portfolio companies and funds on Carta. For tear sheet requests, use carta-lp-reporting-routing instead.

ユースケース

ポートフォリオ企業のティアシートをダウンロードしたいとき
ファンドのティアシートをダウンロードしたいとき
投資対象企業の概要資料を取得したいとき

本文（日本語訳）

ティアシート（企業概要資料）をダウンロード

概要

Cartaのポートフォリオ企業およびファンドのティアシートをダウンロードします。

このスキルはテンプレートとポートフォリオ企業を対話的に表示した後、選択内容に基づいて適切なワークフローに振り分けます：

全ファンドの全ポートフォリオ企業 → 全体ダウンロード：ファンド別の分類が不要な高速処理
特定のポートフォリオ企業（1社以上） → 一括ダウンロード：ファンド別の分類を作成し、非同期でZIPファイルを生成。完成までポーリング（定期確認）し、ダウンロードURLを提供

使用するとき

次のような場合に使用：

「[企業名]のティアシートを作成して」
「[企業名]のティアシートを生成して」
「全ポートフォリオ企業のティアシートをダウンロードして」
「一括ティアシートパッケージを作成して」
「[企業名]のティアシートをプレビューして」
「[ファンド名]の全企業のティアシートを生成して」
「全ティアシートをZIPでダウンロードして」
その他：「ティアシート」「企業概要資料」「PDFで生成」「パッケージダウンロード」など

前提条件

Carta MCPサーバーが接続されていること
アクティブなファーム（企業集団）コンテキストが存在すること。設定されていない場合は、他の操作の前に list_contexts を実行してから set_context でターゲットの firm_id を設定してください
ファンドUUIDやポートフォリオ企業UUIDを事前に知っている必要はありません。どちらも fa:list:tearsheet_templates と fa:list:portfolio_companies で対話的に解決されます

データ取得

MCPコマンド	目的
`call_tool({"name": "fa__list__tearsheet_templates", "arguments": {}})`	企業で利用可能なPDFテンプレートの一覧
`call_tool({"name": "fa__list__portfolio_companies", "arguments": {}})`	全ポートフォリオ企業をファンド分類付きで一覧表示
`call_tool({"name": "fa__mutate__download_all_tearsheets", "arguments": {...}})`	全企業の非同期一括ダウンロードジョブを開始（高速処理）
`call_tool({"name": "fa__mutate__start_tearsheet_download", "arguments": {...}})`	特定企業の非同期一括ダウンロードジョブを開始
`call_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}})`	非同期ジョブの完了状態をポーリング。`"pending"` またはダウンロードURLを返す

ステップ0：ファームコンテキストの確認

list_contexts を実行してアクセス可能なファームを確認
set_context でターゲットの firm_id を指定

ユーザーにファームUUIDを尋ねる必要はありません。MCPセッションがアクティブなファームを追跡しています。

ステップ1：テンプレートを選択

実行：

call_tool({"name": "fa__list__tearsheet_templates", "arguments": {}})

一致するテンプレートが見つかった場合： ユーザーに確認

「テンプレート『投資サマリー』が見つかりました — これでよろしいですか？」

「はい」なら保存して進みます。「いいえ」なら全テンプレート表を表示します。
一致するテンプレートが見つからない場合： ユーザーに通知してから全テンプレート表を表示

「このファームに『投資サマリー』という名前のテンプレートは見つかりません。利用可能なテンプレートは以下の通りです — どちらを使いますか？」

ドキュメント名が指定されていない場合：

テンプレートが1つ： 進む前にユーザーに確認

テンプレートが複数： 表を表示し、ユーザーに番号で選択させます

| # | id | 名前 | 向き | 粒度（情報の詳細レベル） | 説明 |
|---|----|------|------|-------------|------|
| 1 | aaa-... | Q4 2024標準版 | 横向き | ファンド | — |
| 2 | bbb-... | 年次サマリー   | 縦向き  | 企業 | 年間LP報告書 |

TEMPLATE_UUID（テンプレートの id）と TEMPLATE_NAME として保存します。

ステップ2：ポートフォリオ企業を選択

実行：

call_tool({"name": "fa__list__portfolio_companies", "arguments": {}})

このコマンドはポートフォリオ企業の配列を返します。各項目は name、entity_link_id、fund_uuid を含みます。

fund_uuid でグループ化し、番号付き表を表示：

## Acmeファンド I
| # | 企業名 | entity_link_id | fund_uuid |
|---|--------|----------------|-----------|
| 1 | Alpha企業 | el-uuid-1      | fund-uuid-1 |
| 2 | Beta企業  | el-uuid-2      | fund-uuid-1 |

## Acmeファンド II
| # | 企業名 | entity_link_id | fund_uuid |
|---|--------|----------------|-----------|
| 3 | Gamma企業 | el-uuid-3      | fund-uuid-2 |

ユーザーに選択肢を示します：

全ファンドの全企業
特定ファンドの全企業
特定の企業 — 行番号または entity_link_id で指定

ステップ3：ルーティング

ユーザーがポートフォリオ企業を選択した後：

全ファンドの全企業が選択された → 全体ダウンロード処理に進む
1社以上の特定企業が選択された → FUND_BREAKDOWNS を構築して一括ダウンロード処理に進む

全体ダウンロード処理（全企業）

開始前に確認サマリーを表示 — ユーザーの明確な承認なしに進まない：

全ポートフォリオ企業のティアシートを生成する準備ができました：

  テンプレート：<TEMPLATE_NAME> (<TEMPLATE_UUID>)
  範囲：全ファンドの全企業

進みますか？（はい/いいえ）

全体ダウンロードコマンドでバッチジョブを開始：

call_tool({"name": "fa__mutate__download_all_tearsheets", "arguments": {
  "template_uuid": "<TEMPLATE_UUID>"
}})

ユーザーにジョブが開始され、ポーリングが開始されることを告知します。

完了までポーリング — call_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}}) を30秒間隔で最大10回（合計5分）実行：

レスポンスが "pending" → 進捗を表示（「処理中... （N/10回目）」）して待機
レスポンスがURLを含む → ジョブ完了。DOWNLOAD_URL として取得
レスポンスがエラーメッセージ → エラーを表示して停止

成功時： ダウンロードリンクを表示：

成果物を直接ダウンロードしない。常にダウンロードリンクを提示してください。

ティアシートの準備ができました！

[ティアシートをダウンロード](<DOWNLOAD_URL>)

> 注意：このリンクは一時的で有効期限があります。すぐにダウンロードしてください。

一括ダウンロード処理（複数企業）

FUND_BREAKDOWNS を構築 — entity_link_id を fund_uuid でグループ化：

[
  {"fund_uuid": "fund-uuid-1", "entity_link_ids": ["el-uuid-1", "el-uuid-2"]},
  {"fund_uuid": "fund-uuid-2", "entity_link_ids": ["el-uuid-3"]}
]

開始前に確認サマリーを表示 — ユーザーの明確な承認なしに進まない：

一括ティアシートを生成する準備ができました：

  テンプレート：Q4 2024標準版 (aaa-...)
  企業数：2ファンド中3社

    Acmeファンド I
      - Alpha企業
      - Beta企業
    Acmeファンド II
      - Gamma企業

進みますか？（はい/いいえ）

バッチジョブを開始：

call_tool({"name": "fa__mutate__start_tearsheet_download", "arguments": {
  "template_uuid": "<TEMPLATE_UUID>",
  "fund_breakdowns": <FUND_BREAKDOWNS>
}})

ユーザーにジョブが開始され、ポーリングが開始されることを告知します。

完了までポーリング — call_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}}) を15秒間隔で最大20回（合計5分）実行：

レスポンスが "pending" → 進捗を表示（「処理中... （N/20回目）」）して待機
レスポンスがURLを含む → ジョブ完了。DOWNLOAD_URL として取得
レスポンスがエラーメッセージ → エラーを表示して停止

成功時： ダウンロードリンクを表示：

成果物を直接ダウンロードしない。常にダウンロードリンクを提示してください。

ティアシートの準備ができました！

[ティアシートをダウンロード](<DOWNLOAD_URL>)

> 注意：このリンクは一時的で有効期限があります。すぐにダウンロードしてください。

エラーハンドリング

ファームコンテキストエラー： list_contexts と set_context を実行してコンテキストを再確立
テンプレートが返されない場合： ファームがティアシートテンプレートを設定していない可能性があります。Cartaアプリで確認するか、サポートに連絡してください
ポートフォリオ企業が返されない場合： ファームにポートフォリオ企業がない可能性があります。正しいファームコンテキストがアクティブであることを確認してください
一括ジョブが失敗した場合： テンプレートまたはポートフォリオ企業の選択が無効な可能性があります。別の選択を試してください
自動的に再試行しない — 完全なエラー内容を表示し、ユーザーに判断させてください

原文（English）を表示

<carta-plugin>carta-investors:6.38.0</carta-plugin>

Download Tearsheet

Overview

Download tear sheets for your portfolio companies and funds on Carta.

The skill presents available templates and portfolio companies interactively, then routes to the appropriate workflow based on the selection:

All portcos across all funds → Download All: fast path — no fund breakdown needed.
Specific portcos (one or more) → Bulk: builds fund breakdowns, async ZIP archive, polled until complete, download URL provided.

When to Use

"Create a [Portco] tear sheet"
"Generate a tear sheet for [Portco]"
"Download tear sheet for all portfolio companies"
"Create a bulk tear sheet package"
"Preview the tear sheet for [Portco]"
"Generate tear sheets for all portcos in [Fund]"
"Download all tear sheets as a ZIP"
Other trigger phrases: "tear sheet for portco", "tear sheets for all portcos", "preview tear sheet", "generate tear sheet PDF", "create tear sheet", "download tear sheet package", "download all tear sheets".

Prerequisites

The Carta MCP server must be connected.
A firm context must be active. If not set, call list_contexts then set_context with the target firm_id before any other call.
No fund UUID or portco UUID needs to be known in advance — both are resolved interactively via fa:list:tearsheet_templates and fa:list:portfolio_companies.

Data Retrieval

MCP Command	Purpose
`call_tool({"name": "fa__list__tearsheet_templates", "arguments": {}})`	List available PDF templates for the firm
`call_tool({"name": "fa__list__portfolio_companies", "arguments": {}})`	List all portfolio companies with their fund groupings
`call_tool({"name": "fa__mutate__download_all_tearsheets", "arguments": {...}})`	Start an async job for all portcos (fast path)
`call_tool({"name": "fa__mutate__start_tearsheet_download", "arguments": {...}})`	Start an async bulk job for a specific portco subset
`call_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}})`	Poll for async job completion; returns `"pending"` or a download URL

Gate 0: Firm Context

Ensure a firm context is active. If this is your first MCP call in the session, or if subsequent calls fail with a firm/context error:

Call list_contexts to see which firms are accessible.
Call set_context with the target firm_id.

You do not need to ask the user for a firm UUID — the MCP session tracks the active firm.

Gate 1: Select Template

Call:

call_tool({"name": "fa__list__tearsheet_templates", "arguments": {}})

If the user mentioned a document name (e.g. "Investment Summary", "Fund Summary", "Tear Sheet"): match it against the template name field (case-insensitive, partial match).

Match found: Confirm with the user:

"Found template 'Investment Summary' — is this the one you want?"

If yes, store it and continue. If no, show the full table.
No match found: Tell the user, then show the full table:

"No template named 'Investment Summary' was found for this firm. Here are the available templates — which one would you like to use?"

If no document name was mentioned:

One template: Confirm with user before proceeding.

Multiple templates: Show table, ask user to select by number:

| # | id | Name | Orientation | Grain Level | Description |
|---|----|------|-------------|-------------|-------------|
| 1 | aaa-... | Q4 2024 Standard | landscape | fund | — |
| 2 | bbb-... | Annual Summary   | portrait  | company | Annual LP report |

Store as TEMPLATE_UUID (the template id) and TEMPLATE_NAME.

Gate 2: Select Portfolio Companies

Call:

call_tool({"name": "fa__list__portfolio_companies", "arguments": {}})

The command returns an array of portfolio companies. Each item includes name, entity_link_id, and fund_uuid.

Group them by fund_uuid and display a numbered table:

## Acme Fund I
| # | Company Name | entity_link_id | fund_uuid |
|---|--------------|----------------|-----------|
| 1 | Portco Alpha | el-uuid-1      | fund-uuid-1 |
| 2 | Portco Beta  | el-uuid-2      | fund-uuid-1 |

## Acme Fund II
| # | Company Name | entity_link_id | fund_uuid |
|---|--------------|----------------|-----------|
| 3 | Portco Gamma | el-uuid-3      | fund-uuid-2 |

Ask the user to choose:

All portcos across all funds
All portcos in a specific fund
Specific companies — by row number or entity_link_id

Gate 3: Route

After the user selects portcos:

All portcos across all funds selected → proceed to Download All Flow.
One or more specific portcos selected → build FUND_BREAKDOWNS and proceed to Bulk Flow.

Download All Flow (all portcos)

Present a confirmation summary before starting — never proceed without explicit user approval:

Ready to generate tearsheets for all portfolio companies:

  Template:  <TEMPLATE_NAME> (<TEMPLATE_UUID>)
  Scope:     All portcos across all funds

Proceed? (yes/no)

Start the bulk job using the download-all command:

call_tool({"name": "fa__mutate__download_all_tearsheets", "arguments": {
  "template_uuid": "<TEMPLATE_UUID>"
}})

Tell the user the job has started and polling will begin.

Poll for completion — call call_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}}) every 30 seconds, up to 10 attempts (5 minutes total):

Response is "pending" → print progress ("Still processing... (attempt N/10)") and wait.
Response contains a URL → job complete. Capture as DOWNLOAD_URL.
Response is an error message → surface it and stop.

On timeout (10 attempts exhausted): Tell the user the job may still be running and they can check manually by asking: "Check tearsheet download status".

On success: Present the download link:

DO NOT try to download the artifact directly. ALWAYS present the download link.

Your tear sheets are ready!

[Download Your Tear Sheets](<DOWNLOAD_URL>)

> Note: this link is temporary and will expire — download it soon.

Bulk Flow (multiple portcos)

Build FUND_BREAKDOWNS — group entity_link_ids by fund_uuid:

[
  {"fund_uuid": "fund-uuid-1", "entity_link_ids": ["el-uuid-1", "el-uuid-2"]},
  {"fund_uuid": "fund-uuid-2", "entity_link_ids": ["el-uuid-3"]}
]

Present a confirmation summary before starting — never proceed without explicit user approval:

Ready to generate bulk tearsheets:

  Template:  Q4 2024 Standard (aaa-...)
  Portcos:   3 companies across 2 funds

    Acme Fund I
      - Portco Alpha
      - Portco Beta
    Acme Fund II
      - Portco Gamma

Proceed? (yes/no)

Start the bulk job:

call_tool({"name": "fa__mutate__start_tearsheet_download", "arguments": {
  "template_uuid": "<TEMPLATE_UUID>",
  "fund_breakdowns": <FUND_BREAKDOWNS>
}})

Tell the user the job has started and polling will begin.

Poll for completion — call call_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}}) every 15 seconds, up to 20 attempts (5 minutes total):

Response is "pending" → print progress ("Still processing... (attempt N/20)") and wait.
Response contains a URL → job complete. Capture as DOWNLOAD_URL.
Response is an error message → surface it and stop.

On timeout (20 attempts exhausted): Tell the user the job may still be running and they can check manually by asking: "Check tearsheet download status".

On success: Present the download link:

DO NOT try to download the artifact directly. ALWAYS present the download link.

Your tear sheets are ready!

[Download Your Tear Sheets](<DOWNLOAD_URL>)

> Note: this link is temporary and will expire — download it soon.

Error Handling

Firm context error: Call list_contexts and set_context to re-establish context.
No templates returned: The firm may not have tearsheet templates configured. Check the Carta app or contact support.
No portcos returned: The firm may not have portfolio companies. Verify the correct firm context is active.
Bulk job failure: Template or portco selection may be invalid. Retry with different selections.
Never retry automatically — surface the full error and let the user decide.

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。