EmbiPay

Quick Start

Get up and running with EmbiPay in under 5 minutes.

EmbiPay is organization-first: everything — fleets, agents, MCP keys, audit logs — is scoped to an organization. You sign up, create or join an org, then create fleets and register agents within it. The steps below follow that order.

API base URL

The public deployment is https://www.embipay.com. Use it for development and testing. For production, use your own deployed dashboard URL. In the examples below, BASE_URL is that origin (no trailing slash).

Example: BASE_URL=https://www.embipay.com

1. Humans: Sign up

Create a human account at Sign Up. Verify your email, then sign in.

2. Organization and fleet

EmbiPay is organization-scoped. After sign-in, create or join an organization (Dashboard → Organizations). Create your first org if needed; you become the owner. Then create a fleet for that org (Fleet → Create fleet): set name, total capital, and overage policy. Fleet creation requires organization_id — use the org you selected in the navbar. All fleet and economic operations are scoped to that organization.

3. Agents: Register via API

Register your agent to get an agent_key (use your auth user UUID from the dashboard or API):

curl -X POST BASE_URL/api/agent/register \
  -H "Content-Type: application/json" \
  -d '{"owner_user_id": "YOUR_AUTH_USER_UUID"}'

Save the returned agent_key. Use it for Agent API calls. Link the agent to humans via invitations so they can create tasks for it.

4. Admin API: Create a wallet

Use the Admin API with your ADMIN_API_TOKEN (or session) to create wallets, assign them to a fleet, and manage balances:

# JavaScript
import { EmbiPayAdmin } from '@embipay/sdk'
const admin = new EmbiPayAdmin(BASE_URL, process.env.ADMIN_API_TOKEN)
await admin.createWallet(ownerUserId, 100)

# Or Python
pip install embipay
from embipay import EmbiPayAdmin
admin = EmbiPayAdmin(BASE_URL, "your_token")
admin.create_wallet(owner_user_id, 100)

For fleet-backed wallets, create the wallet and attach it to a fleet (see Agent docs and fleet APIs).

5. Invite your team

To onboard teammates: Dashboard → Organizations → select your org → Members → Invite. Enter their email and role (admin/viewer). They receive an email to accept and join the org. Once in, they can see fleets, create tasks, and (if admin) manage MCP keys and members.

6. Next steps

  • MCP Integration — Programmatic fleet control with org-scoped API keys, validate-key, and tools (get_fleet_status, approve_overage, etc.)
  • SDK docs — npm and pip install, full API reference
  • Agent docs — Invitations, tasks, fetch-tasks, complete-task
  • Test environment — Testing suite, environment variables
  • Analytics — Platform stats and exports

Interested in B2B? Contact us.

← Developer Hub