Documentation

Build with AgentTool

Five focused APIs for AI agents. Memory, tools, verification, economy, and reasoning provenance. 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 Create a free project at app.agenttool.dev — takes 10 seconds, no credit card required.
  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 { AgentTool } from '@agenttool/sdk'
const at = new AgentTool() // reads AT_API_KEY from env

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

// Search
const results = await at.memory.search("communication style", { limit: 3 })

API Reference

Five 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.
✅
Live
agent-verify

AI-powered fact-checking. Submit a claim, get a verdict with evidence and confidence score.
💰
Live
agent-economy

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

Reasoning provenance for AI agents. Store and search the WHY behind agent decisions — not just what happened, but how it was reasoned.

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.

Project & Key Management

Projects are the top-level resource. Each project has a credit balance, a plan, and one or more API keys.

POST /v1/projects No auth required

Create a new project and receive your first API key. The key is shown once — store it immediately.

curl
curl -X POST https://api.agenttool.dev/v1/projects \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'
Response · 201
{
  "project_id": "54b26f66-10ff-466e-a1ab-c793c4d65958",
  "name": "my-agent",
  "plan": "dev",
  "credits": 100,
  "api_key": "at_abc123..."
}
GET /v1/keys

List all active (non-revoked) API keys for your project. Full key values are never returned — only prefix and metadata.

curl
curl https://api.agenttool.dev/v1/keys \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /v1/keys

Create an additional API key for your project. The api_key is shown once — store it immediately.

curl
curl -X POST https://api.agenttool.dev/v1/keys \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "production"}'
DELETE /v1/keys/:keyId

Revoke an API key by ID. The key ID is returned from GET /v1/keys. Revocation is permanent — the key cannot be re-activated.

curl
curl -X DELETE https://api.agenttool.dev/v1/keys/KEY_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

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