What programming languages can I use?

Any language that can make HTTP requests. The REST API uses standard JSON. Ed25519 signing is supported by Node.js, Python, Go, Rust, and every major language.

Is there a rate limit?

Search endpoints: 100 requests/minute. Publisher endpoints: 10 requests/minute. Content updates: 30 requests/minute. Contact us for higher limits.

Can I use the MCP server with my own AI agent?

Yes. Any MCP-compatible client can connect to the ACN MCP server. This includes custom agents built with Anthropic Claude, OpenAI, and other platforms.

What happens if I lose my private key?

The private key cannot be recovered. You will need to re-verify your domain through the registration flow to receive a new keypair.

ACN API Reference | Word Of Clout Developer Docs

API Overview

The Agent Content Network provides two integration paths:

REST API

Standard HTTP endpoints for search, registration, verification, and content updates. Base URL: https://wordofclout.ai/api/acn/v1

MCP Server

Model Context Protocol server that AI platforms connect to as a tool. Exposes five operations: query, get, facts, qa, and verify. Any MCP-compatible AI platform can connect directly.

Authentication

Public endpoints (search) require no authentication. Publisher endpoints (register, verify) use the registration flow. Content update endpoints require:

Authorization: Bearer acn_pub_... — API key issued at verification
X-ACN-Signature — Ed25519 signature of SHA-256(body):timestamp
X-ACN-Timestamp — ISO 8601 timestamp, must be within 5 minutes of server time

Search Endpoint

GET /api/acn/v1/search?q={query}&city={city}&limit={n}

Returns ranked business results from the content_objects collection. No authentication required.

Parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search query (business name, category, or service)
`city`	string	No	City filter. Accepts "St. Louis, MO" or "Miami" format
`limit`	integer	No	Max results (default: 10, max: 50)

Response

Returns objects[] with full content object data including provenance chain, quality signals, and a citation_id for the query.

Publisher Registration Flow

Step 1: Register

POST /api/acn/v1/publisher/register

Body: { "email": "you@domain.com", "domain": "domain.com", "businessName": "Your Business" }

Returns: publisher_id, verification token, DNS record instructions. Layer 2 signal assessment runs automatically.

Step 2: Verify

GET /api/acn/v1/publisher/verify?domain={domain}&publisher_id={id}

Checks DNS TXT record. On success: Ed25519 keypair generated, API key issued, status set to 'verified'. Private key returned once — save it immediately.

Step 3: Update Content

PATCH /api/acn/v1/content/update

Requires Bearer auth + Ed25519 signature + timestamp. Updates specific fields on your content object. Only whitelisted fields accepted. Content hash and quality score recomputed automatically.

ACN API Reference: Complete Developer Documentation