Skip to content

Your first calls

Implemented

Read a workspace, its setup, its business details and its saved work before you write anything.

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 and errors.