Documentation
AEOForged is a developer platform for Answer Engine Optimization (AEO) — a REST API, MCP integration, and AI-agent tooling to research, score, audit, monitor, and improve how content is cited by AI answer engines including Google AI Overviews, Perplexity, ChatGPT, and Bing Copilot.
Integrate AEOForged into your stack by calling the REST API from code, connecting AI agents such as Cursor and Claude Code via MCP, or using the platform UI. The documentation is organised into 10 sections covering getting started, audit workflows, API reference, agent integration, prompting, workflows, monitoring, and release history.
Start here
Getting Started
Choose your path (site manager or IDE builder), try free tools, and understand Agency pricing and honesty guardrails.
Read guideAudit Workflow
Run a site audit, fix issues from the action queue, verify that fixes landed, and share a curated report with stakeholders.
Read guideIn this documentation
- Getting Started— The getting-started guide leads with agency and in-house site management, then IDE builder workflows.
- Audit Workflow— The audit workflow covers diagnose, action queue, agent handoff, verification, and client deliverables.
- REST API Reference— The REST API exposes 25+ endpoints over HTTPS with Bearer-key auth.
- MCP Setup Guide— MCP exposes every AEOForged tool to Cursor, Claude Code, and other MCP clients.
- Prompting Guide— Per-tool prompting tips and parameter strategies for all 29 tools.
- Workflow Recipes— Nine copy-paste workflow recipes chain tools from research to monitoring.
- Agent Skills— Downloadable SKILL.md packages preload agents with AEOForged knowledge.
- Agent Integration Guide— The agent guide defines the research → score → review-gate workflow agents must follow.
- Post-Publish Monitoring— Monitoring tracks citations daily across Brave, Google AI, and Perplexity.
- Changelog— The changelog records every release, new tool, and hardening update.
Last updated
Quick start
1. Sign in and create an API key at Settings → API Keys. 2. Try a free tool: POST /api/v1/score with any markdown. 3. See your score and start building.
What AEOForged includes
AEOForged exposes 29 tools across six categories, each available over both REST (/api/v1/*) and MCP:
| Category | Tools | What it does |
|---|---|---|
| Scoring & packaging | aeo_score, aeo_schema, aeo_extract | Score content across 8 AEO dimensions and package it as JSON-LD or snippet-ready blocks. |
| Content creation | aeo_research, aeo_outline, aeo_write, aeo_polish, aeo_verify | Research-grounded drafting from query to fact-checked, brand-voiced article. |
| Analysis & maintenance | aeo_audit, aeo_compare, aeo_refresh, aeo_cluster, aeo_optimise | Audit live URLs, compare against competitors, and refresh stale content. |
| Site-wide audit | aeo_complete_audit, aeo_verify_page | Discover and score every page on a site, then re-verify fixes against a pinned baseline. |
| Agent readiness | aeo_crawlability, aeo_agent_ready, aeo_agent_policy, aeo_llms_txt | Check AI-bot access and operability, then generate robots rules and llms.txt. |
| Competitive intelligence | aeo_share_of_voice, aeo_moat_check, aeo_track | Measure AI answer visibility, find content gaps, and monitor citations over time. |
REST API Reference
25+ endpoints covering content creation, analysis, monitoring, crawlability, and competitive intelligence. Auth, request/response shapes, error codes, and credit costs.
Read moreMCP Setup Guide
Connect Cursor, Claude Code, or any MCP-compatible client. Copy-paste configs and troubleshooting.
Read morePrompting Guide
Per-tool tips, parameter strategies, and common mistakes. Get better results from every tool call.
Read moreWorkflow Recipes
Nine concrete agent workflow patterns with tool chains, example prompts, and expected credit costs.
Read moreAgent Skills
Downloadable SKILL.md and MCP configs for Cursor and Claude Code. Give your agent AEOForged knowledge out of the box.
Read moreAgent Integration Guide
How AI agents should use AEOForged: research, optional hosted outline/write, score iteration, client profile loading, and review gates.
Read morePost-Publish Monitoring
Track citations across AI answer engines. Score decay alerts, position tracking, and time-to-citation analytics.
Read moreChangelog
Release notes, new tools, hardening updates, and platform improvements.
Read moreDocumentation maintained by Ryan Kings, Founder & CTO at AEOForged. The scoring methodology and tool behaviour described here reflect the live platform.