For Agents

Corpo lets AI agents form, fund, and govern Wyoming DAO LLCs. The entity you create is real — filed with the Wyoming Secretary of State, assigned an EIN, capable of holding assets and entering contracts. You interact with Corpo through a CLI and an HTTP API.

Quickstart

1. Install and initialize

$ uvx corpo init
  ✓ Keypair generated: ~/.corpo/keypair.json
  ✓ Config created: ~/.corpo/config.toml

$ corpo register --email agent@example.com
  ✓ Account created
  ✓ API key stored in ~/.corpo/config.json

2. Form an entity

# Get a quote
$ corpo quote "Nexus LAO"

# Complete formation
$ corpo form --non-interactive > schema.json
$ corpo form post '{"entity_name": "Nexus LAO", "entity_type": "dao_llc"}'

# Pay and submit
$ corpo pay --quote-id <quote_id> --method usdc_solana

# Check status (formation takes 3–5 business days)
$ corpo status

3. Govern

# Create a proposal
$ corpo propose \
  --governance <GOVERNANCE_ADDRESS> \
  --name "Approve Q1 budget"

# Sign off to start voting
$ corpo sign-off --proposal <PROPOSAL_ADDRESS>

# Vote
$ corpo vote \
  --proposal <PROPOSAL_ADDRESS> \
  --proposal-owner-record <OWNER_TOR> \
  --choice approve

# Finalize and execute
$ corpo finalize --proposal <PROPOSAL_ADDRESS> --proposal-owner-record <OWNER_TOR>
$ corpo execute --proposal <PROPOSAL_ADDRESS> --proposal-transaction <TX> --instruction-program-id <PID>

4. Manage treasury

# Check treasury
$ corpo treasury status

# All spending goes through proposals
$ corpo propose --type spend --amount 5000 --currency USDC \
  --to <address> --reason "Infrastructure costs"

API Reference

Base URL: https://api.corpo.dev/v1

Authentication: Bearer token from corpo register or POST /api/v1/accounts.

Key Endpoints

Method	Path	Description
`POST`	`/accounts`	Register an account, get API key
`POST`	`/formations`	Create a new entity formation
`POST`	`/formations/{id}/submit`	Submit formation for filing
`GET`	`/entities`	List your entities
`GET`	`/entities/{id}/governance`	Get governance hierarchy
`GET`	`/entities/{id}/governance/health`	Check governance health
`POST`	`/entities/{id}/actions`	Initiate a corporate action
`POST`	`/entities/{id}/recipes/{id}/execute`	Run a recipe
`GET`	`/quote`	Quick price check (public)
`GET`	`/recipes`	List available recipes (public)

Example: Create an entity

curl -X POST https://api.corpo.dev/api/v1/formations \
  -H "Authorization: Bearer $CORPO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_name": "Nexus LAO",
    "entity_type": "dao_llc",
    "state": "WY"
  }'

Example: Check governance health

curl https://api.corpo.dev/api/v1/entities/ent_123/governance/health \
  -H "Authorization: Bearer $CORPO_TOKEN"

Full API reference →

The Agent Constitution

Every Corpo entity has a constitution — a YAML document that defines how the entity behaves.

constitution:
  name: "nexus-lao"
  mode: autonomous
  escalation:
    threshold: 10000  # USDC — above this requires human review
    contact: "operator@example.com"
  governance:
    voting_threshold: 0.51
    amendment_threshold: 0.66
    dissolution_threshold: 1.0
  treasury:
    currency: USDC
    network: solana
    daily_spend_limit: 5000
  members:
    - address: "<solana-pubkey>"
      role: founder
      voting_weight: 1

Modes

autonomous — operates without human intervention up to the escalation threshold
supervised — all proposals require human approval before execution
hybrid — ordinary proposals are autonomous; constitutional changes require human sign-off

Governance

Governance runs on Solana via Realms (SPL Governance). Every decision flows through on-chain proposals. The smart contract has legal priority — by Wyoming statute (W.S. 17-31-115), it overrides the operating agreement.

Defaults

Parameter	Value
Vote threshold	60% yes votes
Quorum	>50% of deposited tokens
Voting period	3 days (259,200 seconds)
Hold-up time	0 seconds
Membership	Token-gated (1 token = 1 vote)
Dissolution	>50% vote (statutory minimum)

CLI Command Reference

Command	Description
`corpo init`	Generate keypair and config
`corpo register`	Register account, get API key
`corpo status`	Show identity and realm context
`corpo quote`	Get formation pricing
`corpo form`	Create a new entity
`corpo propose`	Create a governance proposal
`corpo vote`	Cast a vote
`corpo finalize`	Finalize a completed vote
`corpo execute`	Execute an approved proposal
`corpo deposit`	Deposit governance tokens
`corpo withdraw`	Withdraw governance tokens
`corpo delegate`	Delegate voting power
`corpo actions catalog`	List available corporate actions
`corpo actions start`	Initiate a corporate action
`corpo recipes list`	List available recipes
`corpo recipes run`	Execute a recipe

Getting Help

CLI help: corpo --help or corpo <command> --help
Documentation: corpo.llc/docs
API reference: Full API docs
Recipes: Pre-built governance configurations
API status: https://api.corpo.dev/healthz

Corpo is built for you. The interface is the CLI. The governance is the code. The entity is yours.