SKILLOfficialproductivity

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コマンド	用途
`read_tool({"name": "fa__list__tearsheet_templates", "arguments": {}})`	企業組織で利用可能なPDFテンプレート一覧を取得
`read_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": {...}})`	特定のポートフォリオ企業を対象とした非同期一括ジョブを開始
`read_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}})`	非同期ジョブの完了状況を確認。`"pending"`（処理中）またはダウンロードURLを返却

ステップ1: ファームコンテキストの確認

ファームコンテキストが有効であることを確認します。セッション開始時の初回MCP呼び出しまたは後続の呼び出しで企業組織/コンテキスト関連のエラーが出た場合：

list_contexts で利用可能なファーム一覧を確認
set_context で対象の firm_id を指定

ユーザーに企業組織のUUIDを尋ねる必要はありません。MCPセッションが現在のアクティブなファームを自動追跡します。

ステップ2: テンプレート選択

以下を実行：

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

ユーザーがドキュメント名を指定した場合（例：「Investment Summary」「Fund Summary」「Tear Sheet」）：テンプレートの name フィールドと照合（大文字小文字を区別せず、部分一致で対応）。

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

「テンプレート『Investment Summary』が見つかりました。こちらでよろしいですか？」

「はい」なら保存して進めます。「いいえ」なら全テンプレート一覧を表示します。
一致するテンプレートがない場合： その旨を伝え、全テンプレート一覧を表示します

「このファームで『Investment Summary』というテンプレートは見つかりませんでした。利用可能なテンプレートは以下の通りです。どちらをお使いになりますか？」

ユーザーがドキュメント名を指定しなかった場合：

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

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

| # | id | 名前 | 向き | 粒度 | 説明 |
|---|----|------|------|------|------|
| 1 | aaa-... | Q4 2024 Standard | 横向き | ファンド | — |
| 2 | bbb-... | Annual Summary   | 縦向き  | 企業 | 年次LP報告書 |

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

ステップ3: ポートフォリオ企業の選択

以下を実行：

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

このコマンドはポートフォリオ企業の配列を返します。各項目には name（企業名）、entity_link_id（企業識別子）、fund_uuid（ファンド識別子）が含まれます。

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

## Acme Fund I
| # | 企業名 | 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
| # | 企業名 | entity_link_id | fund_uuid |
|---|--------|----------------|-----------|
| 3 | Portco Gamma | el-uuid-3 | fund-uuid-2 |

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

すべてのファンド全体のポートフォリオ企業
特定ファンド内のすべてのポートフォリオ企業
特定の企業 — 行番号またはentity_link_idで指定

ステップ4: 処理フロー判定

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

すべてのファンド全体のポートフォリオ企業が選択された → 全企業ダウンロードフローに進む
1社以上の特定ポートフォリオ企業が選択された → FUND_BREAKDOWNS を構築し、詳細一括フローに進む

全企業ダウンロードフロー

実行前に確認サマリーを表示します。ユーザーの明示的な承認なしに進めないでください：

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

  テンプレート：  <TEMPLATE_NAME> (<TEMPLATE_UUID>)
  対象範囲：     すべてのファンド全体のポートフォリオ企業

実行しますか？（はい/いいえ）

全企業ダウンロードコマンドで一括ジョブを開始します：

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

ユーザーに対してジョブが開始されたこと、および定期確認を開始することを伝えます。

完了まで定期確認を実行 — 30秒ごとに read_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}}) を呼び出し、最大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 Standard (aaa-...)
  ポートフォリオ企業：   3社（2ファンド）

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

実行しますか？（はい/いいえ）

一括ジョブを開始します：

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

ユーザーに対してジョブが開始されたこと、および定期確認を開始することを伝えます。

完了まで定期確認を実行 — 15秒ごとに read_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}}) を呼び出し、最大20回（合計5分間）実行します：

応答が "pending" → 進行状況を表示（「処理中です...（確認 N/20）」）し、待機
応答にURLが含まれている → ジョブ完了。DOWNLOAD_URL として記録
応答がエラーメッセージ → エラー内容を表示して終了

タイムアウト時（20回の確認で完了しない場合）： ユーザーに対して、ジョブはまだ実行中の可能性があること、また「ティアシートのダウンロード状況を確認してほしい」と依頼することで手動確認できることを伝えます。

成功時： ダウンロードリンクを提示します

成果物を直接ダウンロードしようとしないでください。必ずダウンロードリンクを提示してください

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

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

> 注記：このリンクは一時的なものであり、有効期限があります。お早めにダウンロードしてください。

エラー処理

企業組織コンテキストエラー： list_contexts と set_context を呼び出してコンテキストを再確立
テンプレートが返却されない場合： その企業組織のティアシートテンプレートが設定されていない可能性があります。Cartaアプリで確認するか、サポートに問い合わせてください
ポートフォリオ企業が返却されない場合： その企業組織にポートフォリオ企業が登録されていない可能性があります。正しい企業組織コンテキストが有効であることを確認してください
一括ジョブが失敗した場合： テンプレートまたはポートフォリオ企業の選択が無効な可能性があります。別の選択肢で再度お試しください
自動的に再試行しないでください。完全なエラー内容

原文（English）を表示

<carta-plugin>carta-investors:6.71.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
`read_tool({"name": "fa__list__tearsheet_templates", "arguments": {}})`	List available PDF templates for the firm
`read_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
`read_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:

read_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:

read_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 read_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 read_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 による自動翻訳です。

SKILLOfficialproductivity

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形式でダウンロードしたい」

前提条件

Carta MCP（独自プロトコル）サーバーが接続されていること
ファーム（企業組織）のコンテキストが有効であること。設定されていない場合は、他のコマンド実行前に list_contexts でコンテキスト一覧を確認し、set_context で対象の firm_id を設定してください
ファンドUUIDやポートフォリオ企業UUIDを事前に把握している必要はありません。fa:list:tearsheet_templates と fa:list:portfolio_companies を通じて対話的に解決します

データ取得

MCPコマンド	用途
`read_tool({"name": "fa__list__tearsheet_templates", "arguments": {}})`	企業組織で利用可能なPDFテンプレート一覧を取得
`read_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": {...}})`	特定のポートフォリオ企業を対象とした非同期一括ジョブを開始
`read_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}})`	非同期ジョブの完了状況を確認。`"pending"`（処理中）またはダウンロードURLを返却

ステップ1: ファームコンテキストの確認

list_contexts で利用可能なファーム一覧を確認
set_context で対象の firm_id を指定

ユーザーに企業組織のUUIDを尋ねる必要はありません。MCPセッションが現在のアクティブなファームを自動追跡します。

ステップ2: テンプレート選択

以下を実行：

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

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

「テンプレート『Investment Summary』が見つかりました。こちらでよろしいですか？」

「はい」なら保存して進めます。「いいえ」なら全テンプレート一覧を表示します。
一致するテンプレートがない場合： その旨を伝え、全テンプレート一覧を表示します

「このファームで『Investment Summary』というテンプレートは見つかりませんでした。利用可能なテンプレートは以下の通りです。どちらをお使いになりますか？」

ユーザーがドキュメント名を指定しなかった場合：

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

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

| # | id | 名前 | 向き | 粒度 | 説明 |
|---|----|------|------|------|------|
| 1 | aaa-... | Q4 2024 Standard | 横向き | ファンド | — |
| 2 | bbb-... | Annual Summary   | 縦向き  | 企業 | 年次LP報告書 |

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

ステップ3: ポートフォリオ企業の選択

以下を実行：

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

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

## Acme Fund I
| # | 企業名 | 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
| # | 企業名 | entity_link_id | fund_uuid |
|---|--------|----------------|-----------|
| 3 | Portco Gamma | el-uuid-3 | fund-uuid-2 |

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

すべてのファンド全体のポートフォリオ企業
特定ファンド内のすべてのポートフォリオ企業
特定の企業 — 行番号またはentity_link_idで指定

ステップ4: 処理フロー判定

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

すべてのファンド全体のポートフォリオ企業が選択された → 全企業ダウンロードフローに進む
1社以上の特定ポートフォリオ企業が選択された → FUND_BREAKDOWNS を構築し、詳細一括フローに進む

全企業ダウンロードフロー

実行前に確認サマリーを表示します。ユーザーの明示的な承認なしに進めないでください：

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

  テンプレート：  <TEMPLATE_NAME> (<TEMPLATE_UUID>)
  対象範囲：     すべてのファンド全体のポートフォリオ企業

実行しますか？（はい/いいえ）

全企業ダウンロードコマンドで一括ジョブを開始します：

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

ユーザーに対してジョブが開始されたこと、および定期確認を開始することを伝えます。

完了まで定期確認を実行 — 30秒ごとに read_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}}) を呼び出し、最大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 Standard (aaa-...)
  ポートフォリオ企業：   3社（2ファンド）

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

実行しますか？（はい/いいえ）

一括ジョブを開始します：

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

ユーザーに対してジョブが開始されたこと、および定期確認を開始することを伝えます。

完了まで定期確認を実行 — 15秒ごとに read_tool({"name": "fa__get__tearsheet_download_status", "arguments": {}}) を呼び出し、最大20回（合計5分間）実行します：

応答が "pending" → 進行状況を表示（「処理中です...（確認 N/20）」）し、待機
応答にURLが含まれている → ジョブ完了。DOWNLOAD_URL として記録
応答がエラーメッセージ → エラー内容を表示して終了

成功時： ダウンロードリンクを提示します

成果物を直接ダウンロードしようとしないでください。必ずダウンロードリンクを提示してください

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

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

> 注記：このリンクは一時的なものであり、有効期限があります。お早めにダウンロードしてください。

エラー処理

企業組織コンテキストエラー： list_contexts と set_context を呼び出してコンテキストを再確立
テンプレートが返却されない場合： その企業組織のティアシートテンプレートが設定されていない可能性があります。Cartaアプリで確認するか、サポートに問い合わせてください
ポートフォリオ企業が返却されない場合： その企業組織にポートフォリオ企業が登録されていない可能性があります。正しい企業組織コンテキストが有効であることを確認してください
一括ジョブが失敗した場合： テンプレートまたはポートフォリオ企業の選択が無効な可能性があります。別の選択肢で再度お試しください
自動的に再試行しないでください。完全なエラー内容

原文（English）を表示

<carta-plugin>carta-investors:6.71.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
`read_tool({"name": "fa__list__tearsheet_templates", "arguments": {}})`	List available PDF templates for the firm
`read_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
`read_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:

read_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:

read_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 read_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 read_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 による自動翻訳です。