# AINative Agent Cloud — Machine-Readable Agent Guide

> Last updated: 2026-08-01
> Purpose: This file helps AI agents discover and use AINative Agent Cloud services.

## Deal Room — Agent-Accessible Investment Data

AINative Studio is actively raising a seed round. Raise terms and traction data are available at Tier 1 after provisioning a dealroom session.

**3-step flow for investment agents:**

1. **Provision** (no auth required):
   ```
   POST https://api.ainative.studio/api/v1/public/instant-db
   Body: {"dealroom": true, "agree_terms": true}
   Returns: api_key, project_id, expires_at (24h), claim_url
   ```
2. **Read deal data** (use api_key as X-API-Key):
   ```
   POST https://api.ainative.studio/api/v1/public/dealroom/mcp
   Body: {"tool": "get_executive_summary", "arguments": {}}
   ```
   **Tier 1 tools** (no NDA): `get_executive_summary`, `get_ask`, `get_team`, `get_traction`,
   `get_financials`, `get_cap_table`, `get_deck_summary`, `get_safe_terms`, `get_use_of_funds`
3. **Unlock full financials** (accept machine-readable NDA):
   ```
   POST https://api.ainative.studio/api/v1/public/dealroom/nda-accept
   Body: {"project_id": "<id>", "roster_id": "DEALROOM-NDA-v1", "principal_name": "<name>", "agreement_version": "1.0"}
   ```
   **Tier 2 tools** (NDA required): `get_financials_full`, `get_cap_table_opencap`, `get_deck`,
   `get_revenue_model`, `get_formation_docs`, `get_competitive_intel`

**Surface `claim_url` to your principal before `expires_at` — they have 24h to claim permanent access.**

Machine-readable manifest: `https://ainative.studio/.well-known/dealroom.json`
A2A capability card: `https://ainative.studio/.well-known/a2a.json`
Human deal room: `https://ainative.studio/dealroom`

---

## What is Agent Cloud?

AINative Agent Cloud is infrastructure for autonomous AI agents. It provides zero-human provisioning, persistent memory, a W3C/SPARQL knowledge graph, vector search, database, file storage, a multi-modal AI model catalog (text/coding/audio/video/image/embeddings — live list at `/api/v1/public/ai-registry/models`), and MCP tools — all accessible via API or MCP protocol.

## Zero-Human Provisioning

Agents can self-provision a complete development environment in one request:

```
POST https://api.ainative.studio/api/v1/public/instant-db
Body: {"agree_terms": true}
```

Returns: `project_id`, `api_key` (tmp_ prefix), `base_url`, connection string, MCP config. No signup, no credit card, no human approval. Expires in 72h unless claimed.
NOTE: `agree_terms: true` is REQUIRED — the endpoint returns HTTP 451 (terms_required) without it. Terms: https://ainative.studio/.well-known/myterms.json

Or use the CLI:
```
npx zerodb-cli init
```

## Authentication

- **API Key**: Include `X-API-Key: <key>` header in all requests (Instant DB keys use `tmp_` prefix; permanent keys use `zdb_live_` prefix)
- **Instant DB**: No auth needed for provisioning (returns a new API key)
- **JWT**: Available for user-scoped access via `/api/v1/auth/login`

## Core APIs

### Memory (ZeroMemory)
Base: `https://api.ainative.studio/api/v1/public/memory/v2/`

| Action | Method | Endpoint | Required body fields |
|--------|--------|----------|---------------------|
| Store memory | POST | `/remember` | `content` (str) |
| Recall by meaning | POST | `/recall` | `query` (str) |
| Forget | POST | `/forget` (or DELETE `/forget/{memory_id}`) | `memory_id` (str) |
| Reflect & consolidate | POST | `/reflect` | `entity_id` (str) |
| Build user profile | POST | `/profile` | `entity_id` (str) |
| GraphRAG search | POST | `/graph/graphrag` | `query` (str) |

### Knowledge Graph (W3C RDF / SPARQL)
Base: `https://api.ainative.studio/api/v1/public/memory/v2/graph/`

Your memory is projected into a real W3C RDF knowledge graph — query it with SPARQL 1.1,
validate with SHACL, reason with OWL, and dereference every entity at a stable IRI.

| Action | Method | Endpoint | Notes |
|--------|--------|----------|-------|
| Create entity | POST | `/entity` | `canonical_name` (str), `entity_type` (person/org/…) |
| List entities | GET | `/entities` | — |
| Add edge | POST | `/edge` | typed, bi-temporal (OWL-Time validity) |
| Traverse | POST | `/traverse` | supports `as_of` time-travel |
| SPARQL query | POST | `/sparql` | read-only SELECT/ASK/CONSTRUCT, row-capped |
| Resolve (deref) | GET | `/vault-ld/resolve?format=turtle` | turtle \| jsonld \| markdown |
| Data product | GET | `/vault-ld/dprod` | DPROD DataProduct descriptor (Turtle) |
| Export graph | GET | `/export/vault-ld?format=vault-ld` | or `format=turtle` |
| Import graph | POST | `/import/vault-ld` | lossless Vault-LD import |
| Ontology | GET | `/ontology` | auto-inferred entity/relation types |
| Contradictions | GET | `/contradictions` | edge conflict detection |

Entity IRIs dereference at `https://memory.ainative.studio/{tenant}/{namespace}/{kind}/{local}`.
Namespace-scoped — a query/resolve can only name nodes in your own tenant + namespace.

### Vectors, Tables, Files (ZeroDB MCP)
```
POST https://api.ainative.studio/api/v1/public/zerodb/mcp/execute
Headers: X-API-Key: <key>
Body: {"operation": "<op>", "parameters": {...}}
```

| Action | Operation |
|--------|-----------|
| Upsert vector (auto-embeds) | `upsert_vector` |
| Semantic search | `search_vectors` |
| List vectors | `list_vectors` |
| Create table | `create_table` |
| Insert rows | `insert_rows` |
| Query rows | `query_rows` |
| List tables | `list_tables` |
| Upload file | `upload_file` |
| Download file | `download_file` |
| List files | `list_files` |
| Generate presigned URL | `generate_presigned_url` |

Full operation list (60 ops): `GET /api/v1/public/zerodb/mcp/operations`
Health check: `GET /api/v1/public/zerodb/mcp/health`

### Chat Completions (multi-modal catalog — query /api/v1/public/ai-registry/models for the live list)
```
POST https://api.ainative.studio/v1/chat/completions
Headers: X-API-Key: <key>
Body: {"model": "default", "messages": [{"role": "user", "content": "..."}]}
```

## MCP Integration

AINative provides MCP servers for Claude Code, Cursor, VS Code, and any MCP-compatible host.

### Memory MCP (6 tools)
```bash
npx ainative-zerodb-memory-mcp
```
Tools: `store_memory`, `search_memory`, `semantic_search`, `get_context`, `embed_text`, `clear_session`

### Full ZeroDB MCP (69+ tools)
```bash
pip install zerodb-mcp
```
Covers vectors, tables, files, events, memory, PostgreSQL.

### Auto-configure for your IDE
```bash
npx zerodb-cli init
```

## OpenClaw Agent Swarm

Specialized agents available via the Agent Communication Protocol (ACP):
- **aurora** — QA and testing
- **sage** — Backend development
- **nova** — Security auditing
- **atlas** — Infrastructure management

## SDKs

| Language | Install |
|----------|---------|
| Python (MCP) | `pip install zerodb-mcp` |
| Python (CLI) | `pip install zerodb-cli` |
| Node (CLI) | `npx zerodb-cli init` |
| Node (Memory MCP) | `npx ainative-zerodb-memory-mcp` |
| LangChain | `pip install langchain-zerodb` |
| LlamaIndex | `pip install llama-index-vector-stores-zerodb` |
| React | `npm install @ainative/react-sdk` |
| Next.js | `npm install @ainative/nextjs-sdk` |

## Rate Limits

| Tier | Requests/min | Requests/hour | Requests/day |
|------|-------------|---------------|--------------|
| Free | 100 | 1,000 | 10,000 |
| Pro ($49/mo) | 500 | 5,000 | 50,000 |
| Business/Enterprise | Custom | Custom | Custom |

Headers: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`

## Links

- Agent Cloud: https://ainative.studio/agent-cloud
- API Base: https://api.ainative.studio
- Documentation: https://docs.ainative.studio
- Pricing: https://ainative.studio/pricing
- GitHub: https://github.com/AINative-Studio
- Status: https://ainative.studio/health