Carta Fund Admin Requests

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

Ask Carta to do something

A request opens a case your Carta Fund Admin team works async. It is the answer whenever the user wants something done and no other skill or Carta command can do it — not a dead end, and never a warehouse query instead.

Commands

Names are verbatim. <SERVER> is whichever Carta MCP server this session has.

fa__create__fund-admin-message takes no firm_uuid — the request is always about the session's active firm. It returns {"workflow_id": <id>}, the case number.

Gate 0 — session + access

1. Call welcome, then get_current_user.

2. No Fund Admin access (fund_admin_access false) → surface verbatim and stop:

   Sending work to a Carta Fund Admin team needs a Carta Fund Administration subscription. I can't find one on your account. If your firm uses Carta Fund Admin, reconnect Carta in Settings → Connectors; otherwise reach out to your Carta account manager.

3. Command missing or erroring as unavailable → surface verbatim and stop:

   Messaging your Carta Fund Admin team isn't enabled for this account yet.

   Do not retry. Do not suggest email or another channel. Do not open a ticket by some other route.

Gate 1 — is this a hand-off or a question? [Hard gate]

Run this before drafting anything. A statement that something is wrong is not the same as an instruction to fix it, and guessing is wrong in both directions: a message the user never wanted sent, or a data answer when they wanted work done.

Skip this gate — the intent is explicit — when the message names the hand-off ("ask Carta to", "have my fund admin", "send this to", "can Carta do this") or gives a direct instruction with an imperative verb and an object ("restate the August accrual", "split the Q3 call", "re-paper the LPA").

Fire this gate when the message only reports a problem or states a need, with no verb saying who acts. Signals: "looks wrong", "isn't right", "is off", "doesn't tie", "we need X", "can you deal with X", "something's up with X".

Call AskUserQuestion — do not write the options as markdown text, because markdown does not block execution and you will answer your own question:

Question: "Do you want me to look into this, or ask your Carta team to fix it?"

Options:

1. Look into it — pull the data and show you what's going on
2. Ask Carta to fix it — send it to your Fund Admin team as a request
3. Both — show you the data first, then send a request if you still want one

Flow 1 — Send a request

Never send an unconfirmed message. It leaves Carta on the user's behalf, so they see the exact text first, every time.

1. Draft it. Write the message yourself from what the user said. Include the fund or entity name, the period, the amounts, and the outcome they want. Detail is what lets the team act without coming back to ask.

2. Confirm. Call the AskUserQuestion tool with the drafted message quoted in full. Do not render the choices as a markdown list — a written list is not a gate, and the send must block on a real user turn:

   • Send it — send as drafted
   • Edit first — take their changes, redraft, confirm again
   • Don't send — stop, no message, no fallback

3. Send on approval, then report:

   Sent to your Carta team — case <workflow_id>. They'll pick it up and reply here. I'll check for a response whenever you ask.

Never estimate a turnaround. Never say "within 24 hours" or similar — you do not know the queue.

One call opens one case. Two unrelated asks are two calls, not one merged message.

Flow 2 — What's open

Staff callers list with fa__list__workflow. Non-staff callers have no list command yet, so ask for the case number instead:

I can pull up a specific request if you have its case number. Listing every open request isn't available to your account yet.

Group listed rows into three. Read status first — it is an integer, and 2 and 3 are terminal, so they outrank whoever the row is pending on:

An unrecognised last_task.template goes under In progress — show it rather than hide it. Age comes from last_activity_at, falling back to created_at.

Status reads Sent (new) / Working (pending-carta) / Ready for you (pending-customer) / Done (status 2) / Canceled (status 3) — the same words the Carta Workhub artifact uses. Each is an event the payload can prove; there is deliberately no "received", because nothing marks a read.

There is no state field and no _links block on this payload. Do not read either, and do not build a URL yourself. A row links out only when it carries workflow_cta_url; workflow_detail_url is a /staff/ route a customer cannot open, so it is never used as a link.

Render each group as its own table, # first so the user can open one by number:

request-generic is a DM workflow, so it has no subject. Take the request label from request_type when it names a real job; when it is empty or generic (other, general, request-generic), fall back to thread_metadata.message_snippet, and read the opening message of the thread if you need a better one. Trim to one line. Link the label itself — never a separate "Open" or "View" column. Show Tasks to complete first, then In progress; collapse Completed to a count unless asked.

Close with:

Enter a number to open that case, or: [N] New request  [R] Refresh

Flow 3 — Read a request

fa__list__workflow-message returns the whole thread in one call, both directions. author.is_staff marks what Carta wrote.

Render it as a conversation, oldest first — "You" and "Carta". Use content_text; when it is empty fall back to content_html with the tags stripped.

Never surface Carta's internal agent output. No run logs, no agent or system names, no internal metadata, no staff scratch notes. A staff message renders as its client-facing text plus a link to review it in Carta, and nothing else. If a message is entirely internal, omit it rather than paraphrasing it.

State plainly whether the ball is with Carta or the user, then:

1 - Reply to Carta   ← recommended2 - Open in Carta3 - Back to queue

Flow 4 — Reply

Same confirmation as Flow 1, including the AskUserQuestion tool: draft, show the exact text, get an explicit yes, then fa__create__workflow-message on the same workflow_id. Read the thread first so the reply answers what was actually asked. Confirm with:

Reply sent on case <workflow_id>.

Then offer Back to queue.

If something goes wrong