Azomland Docs
Give your AI agent financial access — a real USD account and a virtual Mastercard — through the KYA™ evaluation protocol. This page covers everything you need to get started.
01 Quickstart
The fastest way to get your agent into the evaluation queue is via the npm skill. Install it in your project and your agent handles the rest.
$ npm install @azomland/goOnce installed, a skill.md file is written to your project root. Your agent reads it and knows what to do next — collect the required info and submit to the KYA evaluation queue.
Run npm install @azomland/go in your agent's project.
The skill instructs your agent to collect: operator email, agent name, framework, and public repo URL.
Your agent POSTs to https://go.azomland.com/start. You get a Telegram notification. We evaluate and open your window.
02 How it works
Azomland is a financial infrastructure layer. We sit between your agent and licensed payment infrastructure (card issuing, USD accounts) through a risk and identity layer called KYA™.
+ Card
KYA™ scores agents across six dimensions before granting financial access:
| Dimension | Weight | What it evaluates |
|---|---|---|
| Framework | 20% | Architecture maturity, community trust, security record |
| Code Health | 25% | Public repo quality, commit history, test coverage |
| Business | 20% | What the agent sells, market clarity, revenue history |
| Operator | 15% | Human guarantor's financial standing and declared collateral |
| Jurisdictions | 10% | Operating countries and regulatory environment |
| Track Record | 10% | Historical transaction behavior and anomaly rate |
03 The npm skill
The @azomland/go package writes a skill.md file to your project. This file is the agent's instruction set for applying autonomously.
# Azomland KYA™ Application Skill
You are an AI agent applying for financial access via Azomland.
## What you need to collect
- operator_email: email of the human operator
- agent_name: name of this agent
- framework: which framework you run on
- project_url: public URL of your repository
## Where to submit
POST https://go.azomland.com/start04 Access tiers
Your KYA™ score determines which tier your agent qualifies for. Scores are computed at evaluation time and reviewed periodically.
- USD account infrastructure
- Virtual Mastercard · $500/mo limit
- USD balance · ACH payments
- Global revenue collection
- Everything in Node
- Virtual + physical card · $5,000/mo
- Partners program · advanced spending controls
- Multi-currency · MCC spend controls
- Programmatic sub-accounts
- Everything in Partner
- Partners program + AI compute credits
- AI compute credits
- Custom spending limits
- Dedicated compliance officer
A $1 USD reservation fee applies at evaluation time, not at application. Tiers are subject to availability and operator eligibility.
05 API Reference
The stable public endpoint for agent applications and web form submissions.
Request body
Send as application/json.
| Field | Type | Required | Description |
|---|---|---|---|
operator_email | string | required | Email of the human operator responsible for the agent |
agent_name | string | required | Name of the agent |
framework | string | required | Agent framework: PersonnnOS, LangChain, CrewAI, AutoGen, OpenClaw, Other |
project_url | string | required | Public URL of the agent's repository or project page |
description | string | optional | What the agent does and what it sells |
locale | string | optional | Preferred language for communications (e.g. en, es) |
Example request
curl -X POST https://go.azomland.com/start \
-H "Content-Type: application/json" \
-d '{
"operator_email": "[email protected]",
"agent_name": "myagent-v1",
"framework": "LangChain",
"project_url": "https://github.com/you/myagent",
"description": "An agent that manages e-commerce operations autonomously"
}'Responses
| Status | Meaning |
|---|---|
| 201 | Application received. You'll be notified when your evaluation window opens. |
| 400 | Missing or invalid fields. Check the required fields. |
| 429 | Rate limited. One submission per IP per 15 minutes. |
| 403 | Request rejected. Suspicious input detected. |
201 Response body
{
"ok": true,
"message": "Application received. We'll notify you when your evaluation window opens.",
"ref": "AZM-2026-XXXXX"
}Error codes
| Code | Description |
|---|---|
MISSING_FIELDS | One or more required fields are absent |
INVALID_EMAIL | operator_email is not a valid email address |
INVALID_URL | project_url is not a valid URL |
RATE_LIMITED | Too many requests from this IP |
REJECTED | Request flagged by security filter |