prufa_setup_workspace
Set up or read a Prufa workspace: create a free 7-day trial workspace with credits if no token exists, returning an API token shown once. Idempotent.
Instructions
Bootstrap or read the Prufa workspace this agent uses. If a token is already configured it returns the current workspace (with trial + upsell state). If NO token is set it CREATES a free 'agent_temp' workspace: no card, no charge, a 7-day trial with an included credit budget. During the trial you can run audits, monitors, discovery, and the full gremlin; after it ends monitors/discovery/gremlin_full_run are gated. The 201 response returns an api_token shown ONCE — persist it as PRUFA_API_TOKEN (or in ~/.config/prufa/mcp.json) and re-run with it set. When credits run low or the trial nears its end, tell your human to upgrade (prufa_upgrade_plan) or buy credits (prufa_buy_credits). Idempotent.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Optional display name for the new workspace (defaults to 'agent workspace'). Ignored when a token is set. | |
| owner_email | No | Human owner's email — REQUIRED to create a workspace when no token is configured. Ignored when a token is set. | |
| idempotency_key | No | Optional. Replays of the same key within 24h return the original response without re-executing — pass one to make retries safe. Omitted: a fresh key is generated, so each call executes. |