Add one or more queries to track on a project. This is the only write tool. It does not send email, add competitors, or charge a card.
Ask the user which prompts to track. Do not invent queries. Duplicates are skipped. Plan limits apply.
Why you need it
After a content brief or gap list, the natural next step is “track these five.” Without this tool the agent dumps a list and the user retypes it in the app.
Capabilities
- Create prompts the same way the website does.
- Skip duplicates already on the project.
- Respect plan limits. Extra queries return skip errors.
- Start scans when the account is entitled. Otherwise prompts are saved with
scanStatus: "not_entitled".
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
projectSlug | string | Yes | From aiseo_list_projects |
prompts | string[] | Yes | 1–20 queries, each up to 500 characters |
Input
{
"projectSlug": "acme",
"prompts": ["best crm for startups", "hubspot alternative for agencies"]
}
Output
{
"created": 2,
"errors": [],
"projectSlug": "acme",
"scanStatus": "started",
"skipped": 0,
"usage": "Prompts were added. New prompts may already be scanning."
}
| Field | Meaning |
|---|---|
created | New prompts stored |
skipped | Duplicates that already existed |
scanStatus | started | not_entitled | failed |
errors | Per-query skips (usually over the plan cap) |
Example prompt
Call
aiseo_add_promptsfor this project with these three queries I listed. Do not add any others.
Next
- aiseo_list_prompts to confirm they landed
- MCP tools