API Reference

1. Sign up at aeldorado.solanacy.in and activate your free plan with a one-time ₹1 payment.
2. Store your AI provider key — go to Key Vault in the dashboard and add your Gemini, OpenAI, or Anthropic key with an encryption password.
3. Generate an API key — create an aldo-live-xxx key from the API Keys section.
4. Make your first request — send a message to /v1/chat with both headers below.

All API requests require two headers:

Dashboard endpoints (key generation, vault management, billing) use Firebase Auth instead of API keys and are only accessible from the dashboard UI.

Aeldorado doesn't hold an AI provider subscription. You bring your own Gemini, OpenAI, or Anthropic key and pay your provider directly. Your key is stored as AES-256-GCM ciphertext — plaintext is never persisted anywhere.

Supported providers:

See the Vault endpoints section for full details on storing and managing keys.

Auto-routing endpoint. The CEO orchestrator analyzes your message intent and delegates to the right specialist agent automatically. Requires an API key scoped to all or auto.

Request body:

# Auto-routing example
curl -X POST https://api.aeldorado.solanacy.in/v1/chat \
  -H "Authorization: Bearer aldo-live-xxxxxxxxxxxx" \
  -H "X-Encryption-Password: your-vault-password" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Draft a cold outreach email for our SaaS product",
    "provider": "gemini"
  }'

Response:

{
  "id": "aldo_resp_a1b2c3d4e5",
  "object": "chat.completion",
  "agent": "sales",
  "model": "gemini-3.1-flash-lite",
  "provider": "gemini",
  "response": {
    "content": "Subject: Quick question about [Company]...",
    "impact": "LOW",
    "agents_consulted": ["sales"]
  },
  "usage": {
    "calls_current_window": 12,
    "calls_remaining_window": 238,
    "window_resets_in_ms": 12600000,
    "tokens": { "input": 142, "output": 387, "total": 529 }
  },
  "meta": { "processing_time_ms": 1240, "routing": "auto" }
}

Call a specific agent directly, bypassing the CEO orchestrator. Useful when you know exactly which domain you need. Replace :name with the agent identifier.

Available agents: ceo · cfo · sales · support · research · marketing · legal

Request body:

# Call the Legal agent directly
curl -X POST https://api.aeldorado.solanacy.in/v1/agent/legal \
  -H "Authorization: Bearer aldo-live-xxxxxxxxxxxx" \
  -H "X-Encryption-Password: your-vault-password" \
  -H "Content-Type: application/json" \
  -d '{"message": "Review this NDA clause for red flags: ..."}'

Returns your current usage stats, remaining quotas, and plan limits across the rolling 5-hour, 7-day, and 28-day windows. Requires Firebase Auth (dashboard only).

{
  "tier": "growth",
  "tierName": "Growth",
  "usage": { "daily": 47, "weekly": 1840, "monthly": 6204 },
  "limits": { "daily": 400, "weekly": 5500, "monthly": 14000 },
  "remaining": { "daily": 353, "weekly": 3660, "monthly": 7796 },
  "resetsInMs": { "daily": 11400000, "weekly": 427680000, "monthly": 1893600000 }
}

Note: daily = current 5-hour window, weekly = current 7-day window, monthly = current 28-day window. Field names are kept for backward compatibility; they are rolling windows, not calendar periods.

Returns all supported AI providers and their available models. No authentication required.

curl https://api.aeldorado.solanacy.in/v1/providers

Encrypt and store your AI provider key. Requires Firebase Auth. Password must be at least 8 characters.

Returns all stored providers with masked keys. Ciphertext, IV, and salt are never returned.

Permanently remove a stored provider key from your vault. Requires provider in the request body.

Check whether your encryption password can successfully decrypt a stored key. Returns verified: true/false without exposing the key.

Aeldorado has seven purpose-built agents, each specialized for a business domain. Use /v1/chat for auto-routing or call them directly via /v1/agent/:name.

Agents can remember context across sessions when you link an API key to a project. Memory is per-project, not per-key.

Each API key has a scope that limits which agents it can access. Assign the narrowest scope needed.

Limits use rolling windows, not fixed calendar resets. Each window (5-hour, 7-day, 28-day) starts from your first request in that window and expires exactly that duration later. When it expires, your next request starts a brand new window from that moment. When any limit is exceeded, the API returns 429.

Per-key hard limit: 30 requests/minute regardless of plan.

All errors follow this shape:

{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key provided is invalid or has been revoked.",
    "detail": "..."  // present when available
  }
}

Aeldorado speaks MCP (Model Context Protocol), so you can plug it straight into Claude Desktop, Claude.ai, Claude Code, Cursor, or any other MCP-compatible client. Once connected, that AI assistant can manage your API keys, run your agents, check usage, and read/write project memory — all by you just chatting with it normally, no manual API calls needed.

Step 1 — Add the connector

In your MCP client (e.g. Claude.ai → Settings → Connectors, or Claude Desktop → Settings → Connectors), add a new custom connector pointing at:

https://api.aeldorado.solanacy.in/mcp

Step 2 — Approve access

Your client opens an Aeldorado sign-in page. Sign in with the same Google account you use for your Aeldorado dashboard, then click Allow Access. You'll be redirected straight back to your client — no key copying.

Step 3 — Enable MCP Agent Access (for chat & agent tools)

To let the connected assistant actually run your agents (not just manage keys/projects), it needs read access to your provider keys. Go to Dashboard → Settings → MCP Agent Access and click Enable, then Sync. This stores a copy of your vault keys re-encrypted specifically for MCP use — your original vault and its password are untouched.

Step 4 — Start using it

That's it. Try asking your assistant things like:

// Just talk to it naturally — no code needed
"List my Aeldorado API keys"
"Generate a new key scoped to the sales agent"
"Ask the legal agent to review this NDA clause"
"How much usage have I got left this month?"

Available MCP Tools

Once connected, these tools are available to your assistant:

Scope & Limitations

Questions, bugs, or integration help — reach out:

• Email: aeldorado@solanacy.in
• Dashboard: aeldorado.solanacy.in