Documentation

Build with AgentTool

Four focused APIs for AI agents. Memory, tools, verification, and economic primitives. One API key, simple REST endpoints, production-ready.

⚡ Quick Start

Three steps to your first API call. Under 60 seconds.

  1. Get your API key Join the waitlist at agenttool.dev — early access users get 3 months free.
  2. Store your first memory Copy-paste this. Change the API key. Hit enter.
    curl 
    curl -X POST https://api.agenttool.dev/v1/memories \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "semantic",
    "content": "User prefers concise replies. Timezone: UTC+8.",
    "key": "user-prefs",
    "agent_id": "agent-42"
  }'
    Response · 201
    {
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-03-09T12:00:00Z"
}
  3. Search it back Semantic search returns the closest matches — no exact keywords needed.
    curl 
    curl -X POST https://api.agenttool.dev/v1/memories/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "how does the user like to communicate?"}'
SDK Equivalent
import at from '@agenttool/sdk'

// Store
await at.memory.store("User prefers concise replies", { key: "user-prefs" })

// Search
const results = await at.memory.search("communication style")

API Reference

Four services. Each does one thing well. All composed under a single API key.

🧠
Beta
agent-memory

Store, retrieve, and semantically search agent memories across sessions. Namespaced by key and agent.
🛠️
Beta
agent-tools

Web search, page scraping, browser automation, and code execution. The agent's hands.
✅
Coming Soon
agent-verify

Attestation and proof-of-work for agent actions. Verifiable claims with timestamped proofs.
💰
Coming Soon
agent-economy

Wallets, micro-billing, escrow, and agent-to-agent value exchange. The economic layer.

Authentication

All API requests require a Bearer token in the Authorization header.

Every request
Authorization: Bearer YOUR_API_KEY

💡 Base URL: https://api.agenttool.dev — all endpoints are relative to this.

Error Handling

All errors return JSON with a detail field. Common status codes:

StatusMeaningWhat to do
401 Unauthorized Check your API key. Make sure it's in the Authorization: Bearer header.
404 Not Found Resource doesn't exist. Double-check the ID or key.
422 Validation Error Request body is malformed. Check required fields and types in the docs.
429 Rate Limited Too many requests. Back off and retry with exponential delay.
500 Internal Error Our fault. Retry once, then contact support if it persists.
Error response format
{
  "detail": [
    {
      "loc": ["body", "content"],
      "msg": "field required",
      "type": "missing"
    }
  ]
}

Rate Limits

PlanRequests / monthMemory retention
Hatchling (Free) 10,000 30 days
Builder ($29/mo) 500,000 1 year
Scale ($99/mo) 5,000,000 Unlimited