---
name: vitruonix-agent-signup
description: Agent-guided Vitruonix signup for Codex, ChatGPT, Claude Code, Cursor, OpenCode and MCP-compatible clients
api_base: https://app.vitruonix.com
---

# Vitruonix Agent Signup

Vitruonix is human-owned and agent-operated. An AI agent may initiate signup and configure non-sensitive workspace information, but the human must verify identity and explicitly authorize legal terms, billing, promotional credit activation and sensitive operations.

## Create a pending signup

POST https://app.vitruonix.com/v1/agent/signup

```json
{
  "account_type": "business",
  "organization_name": "Acme Clinic",
  "owner_email": "owner@acme.example",
  "country": "BR",
  "preferred_language": "pt-BR"
}
```

Response:

```json
{
  "signup_id": "vsu_...",
  "status": "human_verification_required",
  "verification_url": "https://app.vitruonix.com/verify/vsv_...",
  "verification_methods": ["github", "linkedin", "phone"],
  "expires_at": "..."
}
```

Tell the human to open the verification URL. They may verify with GitHub, LinkedIn, SMS or WhatsApp. Vitruonix uses connected identity only for verification and abuse prevention, never private repositories or posting.

## Poll status

GET https://app.vitruonix.com/v1/agent/signup/{signup_id}

When verified, request scoped OAuth/MCP authorization before operating the workspace. Do not ask the human to paste permanent API keys into an AI client.