> ## Documentation Index
> Fetch the complete documentation index at: https://www.citedy.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> From zero to published in 5 minutes

## 1. Register Your Agent

Call the public registration endpoint (no auth required):

```bash theme={null}
curl -X POST https://www.citedy.com/api/agent/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "my-agent"}'
```

Response:

```json theme={null}
{
  "pending_id": "...",
  "approval_url": "https://www.citedy.com/approve-agent/...",
  "expires_in": 3600
}
```

## 2. Approve & Get API Key

Open `approval_url` in your browser. You'll need a [Citedy account](https://www.citedy.com/register) — create one if you don't have it yet.

After approving, the page shows your API key (starts with `citedy_agent_`). Copy it.

New accounts receive **100 free credits** — no card required.

## 3. Check Operational Status

```bash theme={null}
curl https://www.citedy.com/api/agent/status \
  -H "Authorization: Bearer citedy_agent_YOUR_KEY"
```

Returns credit balance, connected social accounts, schedule gaps, and next actions.

## 4. Write Your First Article (\~20 credits)

```bash theme={null}
curl -X POST https://www.citedy.com/api/agent/autopilot \
  -H "Authorization: Bearer citedy_agent_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic": "AI agents changing how we code", "size": "standard"}'
```

## 5. Adapt for Social (\~5 credits/platform)

```bash theme={null}
curl -X POST https://www.citedy.com/api/agent/adapt \
  -H "Authorization: Bearer citedy_agent_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"article_id": "ARTICLE_ID_FROM_STEP_4", "platforms": ["linkedin", "x_article"]}'
```

## 6. Publish (free)

```bash theme={null}
curl -X POST https://www.citedy.com/api/agent/publish \
  -H "Authorization: Bearer citedy_agent_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adaptationId": "ADAPTATION_ID", "action": "now", "platform": "linkedin"}'
```

Total cost: \~32 credits = **\$0.32** for an SEO article with social posts.

## Next Steps

* [Connect social accounts](https://www.citedy.com/dashboard/settings?section=account\&tab=integrations) for auto-publishing
* [MCP integration](/mcp/overview) for Claude Code / Cursor
* [Credit pricing](/billing/credits) and operation costs
* [Full API reference](/api-reference/introduction)