# Linkio does it for you

Linkio runs the work. What you receive, your jobs in the app and with your AI agent, how you pay, who to ask, and what a managed agent cannot do.

On the managed plan, your account manager at Linkio finds the sites, gets the articles written and placed, and
pays the publishers. You make the decisions that are yours: which sites, which titles, and the invoice.

You do your part through the links Linkio sends you, with your AI agent, or both, on the same account. A managed
agent does different jobs from a self-serve agent: Linkio does the finding, ordering, sending and publisher
payments, so you and your agent read, approve, pay Linkio's invoice and ask your account manager.

## What you receive

Linkio sends you links. None of them needs a login.

| Link | What it asks of you |
|---|---|
| **Your report** | Read what was placed and where each placement stands. Your open decisions are on its **Action Items** tab. |
| **Site approvals** (on the report, **Action Items** tab) | Approve or reject each proposed site. Add a note if you want. |
| **Title approvals** | Approve a title for each article, or reject it with a reason. |
| **An invoice** | Pay it with **Pay This Invoice**. If something on it is wrong, use **Question This Invoice**. |

## Your jobs, in the app and with your agent

For an agent: `account_me` gives the account id (`account.id`). `order_list` gives each order's brands
(`clients[].id`): that is the `clientId` that other tools take.

### See where your links stand

- **In the app:** open **Your report**.
- **With your agent:** `order_list` lists your orders, and `order_get` shows one order with each placement and
  its status; `order_get` also lists the sites that were left out, so count only those with
  `inclusionStatus: included`. `line_items_operations` shows your placements across all orders, 50 at a time
  (`offset` gives the next ones), and `account_activity_feed` lists what happened lately.

### Read your results

- **In the app:** **Your report**.
- **With your agent:** `client_report_highlights` gives a brand's results: the keywords its links are cited for
  in AI assistants, the Google rankings they reached and the deliveries by month.

### Approve sites

- **In the app:** the **Action Items** tab of your report.
- **With your agent:** `site_approval_batch_list` shows each batch of proposed sites and the decision on each
  site. You approve or reject on the report.

### Approve titles

- **In the app:** the title approval link.
- **With your agent:** no tool reads title approvals for a managed key. Use the link, or ask your account manager.

### Pay Linkio

- **In the app:** the invoice link, **Pay This Invoice**.
- **With your agent:** `billing_history` lists your payments and invoices; an invoice still to pay is in
  `unpaidInvoices`. `account_billing_summary` shows your balance. You pay; the agent does not. On `order_get`,
  the payment fields of an order are not an invoice: your invoices are the ones Linkio sends you.

### Ask about a placement

- **In the app:** the email address or the chat that your account manager gave you.
- **With your agent:** `line_item_message_publisher` on a placement of a managed order goes to Linkio's team,
  never to the publisher.

## How you pay

You pay Linkio, by the invoice link or the payment link that Linkio sends you. Linkio pays the publishers. You
never pay a publisher on the managed plan.

## Who to ask

Ask your account manager. Use the email address or the chat that your account manager gave you.

## Your API key (optional)

You can give a tool or an AI agent access to your account. Make a key at
https://www.linkio.com/account/api-keys. For a managed account the page opens on the **Reporting** level: the key
can read your orders, placements and reports, and cannot change anything. Pick **Automation** if your agent
should also send messages about a placement to Linkio's team.

A managed key never shows Linkio's cost, who the publisher is (no name or email), or Linkio's internal notes. It
does show each placement's status with the publisher, including when the publisher is paid, and the publisher's
status updates in the activity feed, for example "Article approved".

To connect an agent with the key: [Connect an agent](/docs/agents). The agent uses Linkio's MCP server,
`https://mcp.linkio.com/mcp`, with the header `Authorization: Bearer <the key>`. An agent that cannot add a tool
server calls the same tools over HTTP, one JSON-RPC request per call:

```
curl -s https://mcp.linkio.com/mcp -H 'Authorization: Bearer acc_your_key' \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"order_list","arguments":{}}}'
```

The answer is an event stream. The tool's answer is the text in `result.content[0].text` on the `data:` line.

The server's list of tools for a managed key also names the self-serve tools; they answer as in the table below.

## What a managed agent cannot do

The self-serve work is Linkio's on a managed account, so these calls are refused for a managed key:

| The work | Tools | The answer |
|---|---|---|
| Search sites | `website_search` | `403` `ACCOUNT_TYPE_DENIED` |
| Make an order, add or change its sites | `order_create`, `line_items_add_to_order`, `line_items_update` | `403` `ACCOUNT_TYPE_DENIED` |
| Add target pages | `target_pages_add` | `403` `ACCOUNT_TYPE_DENIED` |
| Read title approvals | `topic_gen_title_approval_status` | `403` `ACCOUNT_TYPE_DENIED` |
| Write or send an article | `article_gen_start`, `workflow_send_to_publisher` | `403` `ACCOUNT_TYPE_DENIED` |
| Close or move a placement | `line_item_close`, `line_item_replace_site` | `403` `NOT_SELF_SERVE` |
| Pass or fail a live link, record a publisher payment | `line_item_qa_decision`, `account_publisher_invoice_mark_paid` | Refused on a managed order |
| Move the account to self-serve while it has a managed plan | `account_billing_mode` with `mode: self_serve` | `403` `managed_customer`: ask your account manager |