API & downloads

Website Public API

Public HTTP API on https://www.aiagentnet.cloud: quickstart, authentication notes, endpoint reference, and OpenAPI.

Website Public API - Quickstart

'HTTP APIs on ' + escapeHtml(base) + ' for catalog discovery, intent recommendation, and lead capture. Production endpoints. Not the AgentOS X product runtime.'

These website marketing APIs are anonymous (no AGIN). AGIN applies to agent → MCP tool calls in the market/runtime, not to public /api/plans curls below.

Prerequisites: curl and optionally jq. No API key for the endpoints below.

Health
Confirm the site process is up.
cURL · bash
```
curl -sS https://www.aiagentnet.cloud/health
```
Catalog
List products and plans (anonymous).
cURL · bash
```
curl -sS https://www.aiagentnet.cloud/api/plans | jq .
```

Recommend

Send a business prompt; receive scenario, products, plan, and next actions.

cURL · bash

curl -sS -X POST https://www.aiagentnet.cloud/api/agent/intent \
  -H 'content-type: application/json' \
  -d '{"prompt":"sales follow-up for qualified leads"}'

Account
Public APIs stop at discovery. Product delivery (ISO, IM, paid suite) requires an account.

Create an account →

One script

Script · bash

#!/usr/bin/env bash
set -euo pipefail
BASE=https://www.aiagentnet.cloud

curl -sS "$BASE/health" | jq .
curl -sS "$BASE/api/plans" | jq '.plans[0]'
curl -sS -X POST "$BASE/api/agent/intent" \
  -H 'content-type: application/json' \
  -d '{"prompt":"sales follow-up for qualified leads"}' \
  | jq '{status, planId, recommendedProducts, nextActions}'

Authentication

The public website endpoints below require no authentication. Do not send API keys or bearer tokens for them.

Workspace, billing, and product runtime use signed-in sessions or product entitlement. Product install packages on downloads.aiagentnet.cloud are public free (no login). MCP market connectors use caller-supplied third-party credentials as documented by each listing.

Surface	Auth	Purpose
Public website API	None	Health, catalogs, intent, leads
Product downloads (CDN)	None	Server / Desktop ISO and future public installers
MCP connectors (market)	AGIN (which agent) + caller's third-party credentials (which product account)	Accountable tool execution
Customer workspace	Session cookie	Account, entitlement, billing
Product runtime	Product entitlement + agent AGIN	AgentOS X (incl. engine & tools) / IM after install

API reference

Base URL: https://www.aiagentnet.cloud

JSON request bodies use content-type: application/json. Successful responses include request_id. POST /api/agent/intent and POST /api/leads are rate-limited per client.

GET /health No account · no API key

Process health

Liveness probe for the marketing site process. Anonymous. Does not unlock any product delivery.

Request · bash

curl -sS https://www.aiagentnet.cloud/health

Response · json

{
  "status": "ok",
  "service": "agentnet-website",
  "request_id": "req_…",
  "shared_envelope": {
    "success": true,
    "code": "ok",
    "message": "ok",
    "data": { "status": "ok", "service": "agentnet-website" }
  }
}

GET /api/products No account · no API key

Product catalog

Public product list for the active locale. Anonymous read. Marketing catalog only — not product runtime control.

Request · bash

curl -sS https://www.aiagentnet.cloud/api/products

Response · json

{
  "products": [
    {
      "name": "AgentOS X",
      "tag": "Operating system",
      "body": "Self-hosted OS for AI employees…",
      "cta": "See products"
    }
  ],
  "locale": "en",
  "request_id": "req_…"
}

GET /api/scenarios No account · no API key

Use-case catalog

Public use-case catalog with product mix and plan hints. Anonymous read. Does not start product runtime.

Request · bash

curl -sS https://www.aiagentnet.cloud/api/scenarios

Response · json

{
  "scenarios": [
    {
      "id": "commerce",
      "name": "Sales and support",
      "headline": "A qualified lead waits 48 hours…",
      "products": ["IM", "AgentOS X"],
      "planId": "pro"
    }
  ],
  "locale": "en",
  "request_id": "req_…"
}

GET /api/plans No account · no API key

Plan catalog

Public plan list with features and prices. Anonymous read. Free vs paid is about product entitlement after signup—not about calling this catalog API.

Request · bash

curl -sS https://www.aiagentnet.cloud/api/plans

Response · json

{
  "plans": [
    {
      "id": "personal_free",
      "name": "Free",
      "priceCents": 0,
      "currency": "USD",
      "features": ["AgentOS X ISO + AIAGENTNET IM", "…"],
      "action": "signup",
      "checkoutUrl": "/auth/signup"
    }
  ],
  "locale": "en",
  "request_id": "req_…"
}

GET /api/manifesto No account · no API key

Manifesto string

Single product manifesto string for the active locale. Anonymous read.

Request · bash

curl -sS https://www.aiagentnet.cloud/api/manifesto

Response · json

{
  "manifesto": "AI operating system for SMEs and startups",
  "locale": "en",
  "request_id": "req_…"
}

POST /api/agent/intent No account · no API key · rate-limited

Recommend a product path

Anonymous recommendation: business prompt → scenario, products, plan, nextActions. Rate-limited (~12/min/IP). Not product runtime, not tool execution, not a paid gate—anyone can call; it only suggests paths.

Name	In	Required	Description
`prompt`	body	yes	Business question or workflow description (non-empty string).

Request · bash

curl -sS -X POST https://www.aiagentnet.cloud/api/agent/intent \
  -H 'content-type: application/json' \
  -d '{"prompt":"sales follow-up for qualified leads"}'

Response · json

{
  "status": "ready",
  "locale": "en",
  "answer": "Start from Growth and ops teams: … Recommended product mix: AIAGENTNET IM, AgentOS X. Suggested plan: Team. …",
  "scenario": {
    "id": "growth",
    "name": "Growth and ops teams",
    "headline": "A website inquiry should hit a follow-up queue the moment it arrives"
  },
  "recommendedProducts": ["IM", "AgentOS X"],
  "planId": "team",
  "planName": "Team",
  "nextActions": [
    "/auth/signup?intent=team&next=/checkout/team",
    "/pricing",
    "/auth/signup",
    "/auth/login"
  ],
  "request_id": "req_…"
}

invalid_prompt — Missing/empty prompt or bad JSON body → HTTP 400.
rate_limited — Too many requests from the client → HTTP 429 when enforced.

POST /api/leads No account · no API key · rate-limited

Capture a lead

Anonymous lead capture (email + scenario). Rate-limited (~8/min/IP). Does not create a paid entitlement. Do not spam; use real work emails.

Name	In	Required	Description
`email`	body	yes	Work email.
`scenario`	body	yes	Scenario id: enterprise \| commerce \| developer \| growth (or form aliases).
`company`	body	no	Company or team name.
`painPoint`	body	no	Specific friction.
`currentTools`	body	no	Tools in use today.
`desiredAutomation`	body	no	What AI should automate first.
`teamSize`	body	no	Team size band.

Request · bash

curl -sS -X POST https://www.aiagentnet.cloud/api/leads \
  -H 'content-type: application/json' \
  -d '{
    "email":"you@company.com",
    "scenario":"commerce",
    "company":"Acme",
    "painPoint":"Leads wait 48 hours"
  }'

Response · json

{
  "status": "received",
  "scenario": { "id": "commerce", "headline": "…" },
  "recommendedProducts": ["IM", "AgentOS X"],
  "planName": "Pro",
  "nextStep": "…",
  "nextActions": ["…"],
  "request_id": "req_…"
}

invalid_lead — Missing valid email/scenario or bad JSON → HTTP 400.
rate_limited — Too many submissions → HTTP 429 when enforced.

OpenAPI

Machine-readable OpenAPI 3.0 for the website public endpoints above. Import into Postman or generate a client. Contract file for tools - not the MCP market catalog itself.

Download openapi.json

cURL · bash

curl -sS https://docs.aiagentnet.cloud/openapi.json | jq '.paths | keys'

Errors

HTTP	When
`400`	Invalid JSON or missing required fields (`invalid_prompt`, `invalid_lead`)
`429`	Rate limited on intent or leads
`5xx`	Server error - retry with backoff; include `request_id` in support mail