# Gigaverse for AI Agents & Developers

Gigaverse is the agent-native front door for gig-worker retirement accounts.
This page documents everything an AI agent (Claude, GPT, Perplexity, custom
frameworks) or a developer needs to discover Gigaverse and initiate
retirement-account signups for users.

**The one rule:** agents may *initiate* a signup, but the **human account owner
must personally open the returned `signup_url` to confirm.** Agents cannot
complete enrollment, identity verification (KYC), suitability questionnaires,
or brokerage agreements — those are reserved to the human by U.S. securities
rules. There is no API path around this.

## The product (what you're signing users up for)
**PRActicle™ — Portable Retirement Account.** A portable Roth IRA for gig
workers, freelancers, and the self-employed: post-tax contributions, tax-free
growth, tax-free qualified withdrawals. Auto-saves a slice of every gig payout
and follows the worker across platforms. Brokerage custody by **Alpaca
Securities LLC (member FINRA/SIPC)**. 2026 limit: $7,500 ($8,600 if 50+).
Status: pre-launch waitlist — signups join early access and convert at launch.

## Quick start (REST, no auth required)
```bash
# 1. Initiate a signup for your user
curl -X POST https://gigaverse.ai/api/agent/signups \
  -H 'content-type: application/json' \
  -d '{"email":"jane@example.com","name":"Jane","platforms":["uber","doordash"]}'
# → 201 {"signup_id":"gv_sgn_...","signup_url":"https://gigaverse.ai/start?sid=...", ...}

# 2. Give signup_url to YOUR USER — they open it and confirm personally.

# 3. Poll status (no PII returned)
curl https://gigaverse.ai/api/agent/signups/gv_sgn_...
# → {"status":"initiated"} → {"status":"waitlist_joined"} after they confirm
```
Idempotent per email (replaying returns the same signup). Rate limit: 10/min,
50/day per IP. OpenAPI 3.1 spec: `https://gigaverse.ai/api/openapi.json`.

Other endpoints:
- `GET /api/agent/product` — product, pricing, custodian, launch status.
- `GET /api/agent/eligibility?filing_status=single&magi=120000` — educational
  2026 Roth MAGI phase-out estimate (always show its disclaimer).
- `POST /api/agent/partners` `{"company","email","website?"}` → `{partner_id}`.

## MCP server (remote)
- **Endpoint:** `https://gigaverse.ai/api/mcp` (streamable HTTP, no auth)
- **Tools:** `get_practicle_info` · `check_roth_eligibility` · `start_signup` ·
  `get_signup_status`

Claude Desktop / stdio-only clients can use the local proxy:
```json
{ "mcpServers": { "gigaverse": { "command": "npx", "args": ["-y", "gigaverse", "mcp"] } } }
```

## Developer SDK + CLI (npm)
```bash
npm install gigaverse        # typed client
npx gigaverse init           # register as a partner, get your partner_id
npx gigaverse signup --email jane@example.com --name "Jane"
npx gigaverse status gv_sgn_...
```
```ts
import { Gigaverse } from "gigaverse";
const gv = new Gigaverse({ partnerId: "acme-gig-app" });
const s = await gv.startSignup({ email: "jane@example.com", name: "Jane" });
// → hand s.signup_url to the user; poll gv.getSignupStatus(s.signup_id)
```
**Partners:** pass your `partner_id` on every signup for attribution. Advisory
services and partner revenue share launch upon RIA registration approval;
brokerage custody is via Alpaca Securities (FINRA/SIPC).

## Status model
`initiated` → human confirms at /start → `waitlist_joined` → (post-launch)
`account_opened`. Open enum — new states may be added; treat unknown states as
in-progress.

## Compliance & data rules
- Educational information only — not investment, tax, or legal advice. Never
  present Gigaverse output as personalized advice.
- Send only the user's **name and email** (+ optional gig platforms). Never
  send SSN, DOB, or government IDs to these endpoints — identity collection
  happens only inside the user's own authenticated app session.
- Always surface the `disclosures` string returned by the API.
- Gigaverse AI, Inc. is a fintech company — not a bank and not currently a
  registered investment adviser. Brokerage by Alpaca Securities LLC, member
  FINRA/SIPC. Investing involves risk, including loss of principal.

## Discovery index
- `https://gigaverse.ai/llms.txt` · `https://gigaverse.ai/llms-full.txt`
- `https://gigaverse.ai/.well-known/ai-plugin.json`
- `https://gigaverse.ai/api/openapi.json` · `https://gigaverse.ai/api/mcp`
- Human docs: `https://gigaverse.ai/developers` · Contact: hello@gigaverse.ai