Actuent Docs

Everything you need to connect AI agents to the web — or list your site so AI agents can find it.

What is Actuent?

The web was built for humans. When an AI agent tries to browse a normal website, it gets back raw HTML — a wall of tags, scripts, and noise it can't make sense of.

Actuent fixes that. It's a search engine built specifically for AI agents. Agents come to Actuent, search for a site or topic, and get back a LAWP — a clean, structured JSON version of the entire website. Every page. All the content. Every available action. Structured in a way AI can actually read, understand, and reason about.

Groq is used sparingly — only to convert crawled pages into clean LAWP format. The core product is a structured lookup and crawl engine, not an AI generation system.

Quickstart

Get your first LAWP result in 60 seconds. No account needed for the public search layer.

Search for any site

curl -X POST https://api.actuent.ai/api/search \
  -H "Content-Type: application/json" \
  -d '{"query":"barber amsterdam"}'

Response

{
  "query": "barber amsterdam",
  "count": 1,
  "results": [
    {
      "domain": "abdisbarber.com",
      "name": "Abdi's Barber",
      "pages": {
        "/": {
          "title": "Abdi's Barber — Amsterdam",
          "content": "Premier barbershop in Amsterdam. Walk-ins welcome."
        },
        "/services": {
          "title": "Services",
          "content": "Haircut 25€. Beard trim 15€. Full groom 35€."
        }
      },
      "actions": [
        {
          "id": "book",
          "name": "Book appointment",
          "description": "Book a haircut at Abdi's Barber",
          "intent": ["book", "appointment", "haircut", "barber"],
          "input": { "type": "text", "required": false }
        }
      ]
    }
  ]
}

If the site isn't in Actuent's index yet, it gets crawled automatically and converted to LAWP on the fly.

MCP Setup

Plug Actuent into Claude, GPT, or any MCP-compatible AI assistant. Once connected, the AI can call actuent_search natively — no user setup required.

Get an API key

Sign up at actuent.ai to get your API key. Your key authenticates your agent sessions and enables memory across searches.

Connect to Claude

In Claude's MCP settings, add a new server:

{
  "mcpServers": {
    "actuent": {
      "url": "https://agents.actuent.ai/.netlify/functions/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Connect to GPT

In your GPT's tool configuration, add Actuent as a custom action pointing to https://agents.actuent.ai/.netlify/functions/mcp with your API key in the Authorization header.

Available tools

Example tool call

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "actuent_search",
    "arguments": {
      "query": "nike.com"
    }
  }
}

@actuent/sdk

List your site on Actuent so AI agents can find it, read it, and take actions on it. Install the SDK and register your site in minutes.

Install

npm install @actuent/sdk

Register your site

import { register } from "@actuent/sdk"

await register({
  apiKey: "your-actuent-api-key",
  site: {
    domain: "yoursite.com",
    name: "Your Site",
    pages: {
      "/": {
        title: "Your Site — Tagline",
        content: "What your site does in plain English."
      },
      "/pricing": {
        title: "Pricing",
        content: "Starter: £10/month. Pro: £25/month."
      }
    },
    actions: [
      {
        id: "signup",
        name: "Sign up",
        description: "Create a new account",
        intent: ["sign up", "register", "join", "create account"],
        input: { "type": "text", "required": false }
      }
    ]
  }
})

Once registered, your site is immediately discoverable by every AI agent using Actuent.

LAWP Format

LAWP (Locali AI Web Protocol) is the structured JSON format Actuent uses to represent websites. Think of it as HTML — but built for AI agents instead of browsers.

Full structure

{
  "domain": "string",      // e.g. "abdisbarber.com"
  "name": "string",        // Human-readable site name
  "pages": {
    "/path": {
      "title": "string",   // Page title
      "content": "string"  // Plain English summary of page content
    }
  },
  "actions": [
    {
      "id": "string",          // Unique action ID
      "name": "string",        // Human-readable action name
      "description": "string", // What this action does
      "intent": ["string"],    // Keywords that trigger this action
      "input": {
        "type": "text | number | none",
        "required": true | false
      }
    }
  ]
}

Design principles

API Reference

POST/api/search

Search Actuent's index. If a site isn't found, it's crawled and converted to LAWP automatically.

Base URL: https://api.actuent.ai

Request body

Response

POST/api/register

Register a site on Actuent. Used by @actuent/sdk.

Base URL: https://api.actuent.ai

Headers

Request body

A valid LAWP site object — see LAWP Format above.