Running Agents | Markup AI

Markup AI’s content agents are exposed through the Agents endpoints of the API. Each agent runs against the settings configured for your organization in the Markup AI console — no per-call style guide IDs. For what each agent does and why it matters, see the Agent Catalog.

The run flow

Discover the agents available to your organization with GET /agents. Each entry includes the agent’s stable name (e.g. brand_voice), its id, description, and category. Resolve the id from the name at runtime — every agent page below has copy-paste examples that do exactly that.
Run an agent with POST /agents/{agent_id}/run, passing your content as text. Pass wait=true to block until the run completes; otherwise the response returns immediately with a workflow_id.
Track longer runs with GET /agents/workflows/{workflow_id}, stream progress from GET /agents/workflows/{workflow_id}/stream (server-sent events), or supply a webhook_url in the run request to receive the result when the agent finishes.

The agents returned by GET /agents depend on your organization’s plan and feature access.

Agent reference

Agent	API `name`	Category
AI Voice	`ai_voice_detector`	Content Integrity
Brand Terms	`terminology`	Brand
Brand Voice	`brand_voice`	Brand
Claims	`generic_claims`	Accuracy
Date & Time Accuracy	`date_time_accuracy`	Accuracy
Fluff	`focus_agent`	Content Integrity
Freshness	`freshness`	AI Visibility
Key Takeaways	`key_takeaways`	AI Visibility
Link Integrity	`link_integrity`	Accuracy
Persona	`persona`	Brand
Q&A Optimization	`answer_authority`	AI Visibility
Sentence Clarity	`sentence_clarity`	Content Integrity
Snippet Readiness	`snippet_readiness`	AI Visibility
Source Authority	`source_authority`	AI Visibility
Style	`style_agent`	Brand

Via MCP

The same agents run on the hosted MCP server at https://api.markup.ai/mcp/, addressed by the same name used here. Ask for a review and markupai_review picks the agents for you, or name them explicitly with markupai_run_agents — see the MCP overview to connect Claude, Cursor, or any other MCP client.