> ## Documentation Index
> Fetch the complete documentation index at: https://mcp.shipcontent.com/llms.txt
> Use this file to discover all available pages before exploring further.

---
title: Your first calls
description: Read a workspace, its setup, its business details and its saved work before you write anything.
section: start
order: 40
status: implemented
mode: both
reviewed: 2026-10-05
sources: [src/lib/docs/handoffs.ts, src/lib/server/database/queries.ts, src/lib/mcp/agent-tools.ts, src/lib/server/mcp/AgentMcp.ts]
tools: [list_workspaces, get_onboarding_status, get_workspace, update_workspace, list_assets, list_posts, create_post, edit_post]
next: [/docs/contracts/approval-model, /docs/workflows/business-details]
---
## 1. Select a workspace

Call `list_workspaces` without a `workspaceId`. Use one returned `workspaceId` for later calls. The list contains every workspace of the owner who connected this client, including new ones. Read `access.canPublish` for this agent's Publish permission. An empty list means the owner has no workspace or the client is disconnected; send the owner to `/agent-access`.

## 2. Read saved progress

Call `get_onboarding_status` with that `workspaceId`. It shows saved profile, media budget, posts, provider-scoped social identities, Instagram, delivery, and observations. Saved metadata is not a fresh provider check.

## 3. Read business details

Call `get_workspace`. The workspace name is the business name, and `profile` holds the business details. If facts are missing, ask the owner, then save them with `update_workspace`. The save takes effect at once.

## 4. Read assets and drafts

Call `list_assets` and `list_posts`. `list_assets` returns metadata, not file bytes or a preview. The post result includes protected owner review links; only the signed-in owner can use them.

## 5. Draft

Call `create_post`. It creates a free template, not a paid generation, upload, schedule or publication. Give the review link to the owner. Use `edit_post` to change an unapproved draft.

For each write, follow the ID field declared by that tool's input schema. Replay the same ID with identical input after an uncertain response, then read current state. Do not make a second paid or provider operation to repair a missing reply.

Updated 2026-10-17: After selecting a workspace, use `get_credit_balance` and `get_credit_prices` to inspect saved credits, limits and current price estimates. These reads remain free at zero or without a plan. Exact credit amounts are strings. A current price estimate is not owner approval. On `PRICE_CHANGED`, refresh it and request renewed owner approval before paid work. See [billing](/docs/workflows/billing) and [errors](/docs/contracts/errors).
