Create a watched project
create_projectCreate a project: a site MeshArc re-crawls on a schedule, comparing each run with the last to record pages added, modified and removed. Use it when asked to monitor or track a site; for a one-off read use crawl_site. Check list_projects first so the site is not added twice. Inputs: seed starts a new project, e.g. 'example.com'. crawl_id instead keeps a crawl_site crawl from the last day as the first run, with no second fetch; it keeps that crawl's settings, so config goes only with seed -- except its page limit: the crawl's limit was how much to look at once, so the project gets a project's default (100, within the plan), which update_project changes. The usual config keys are include_paths (one section, e.g. ['/blog/*']), exclude_paths, max_pages and render_js; get_project with no project_id lists them all. Cost: creating reads robots.txt and the sitemaps but no pages, so it is free. Each run spends credits per page, and any schedule but 'manual' runs on its own. Caps: max_credits_per_run stops a run at that many credits, keeping what it read; max_credits_per_month skips scheduled runs once the month has spent that many. 0 or omitted is no cap. Refusals: an unknown config key, or a plan already at its project limit (code plan_limit). Values above the plan's caps are lowered to them. Needs write access; a read-only connection is refused with code 'read_only'.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_project"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | A display name; omit for the site's host (or the crawl's own name). | |
| seed | No | The site to watch, as a URL or bare domain, e.g. 'https://example.com/blog/' or 'example.com'; its host is fixed for good. Give this or crawl_id. | |
| config | No | Settings as {key: value}, with a seed only; omit for the defaults. | |
| crawl_id | No | A crawl_site answer's crawl_id, to keep that crawl as the project. Give this or seed. | |
| schedule | No | How often it re-crawls on its own; 'manual' (default) runs only when start_run is called. | manual |
| max_credits_per_run | No | The most one run may spend, in credits; omit or 0 for no cap. | |
| max_credits_per_month | No | The most its runs may spend in a calendar month, in credits; omit or 0 for no cap. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | The project's 32-character hex id. | |
| code | No | Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found. | |
| host | No | The site it covers; fixed at creation. | |
| name | No | Its display name. | |
| note | No | No project_id only: how path globs work. | |
| seed | No | Where its crawls start. | |
| error | No | Only when the call failed: what went wrong, in words an assistant can act on. | |
| pages | No | Pages its last finished run read, a number. | |
| config | No | Its settings as {key: value}; secrets such as chat_url come back masked. create_project and update_project list only the settings that differ from the defaults; get_project lists them all. | |
| detail | No | Only on a failure: the API's own wording, when the error was rephrased. | |
| status | No | draft, crawling, healthy or failing. On an error, the HTTP status code. | |
| purgeAt | No | When an archived project is deleted for good (ISO 8601), or null. | |
| archived | No | true for an archived project: it runs no more and is deleted on purgeAt unless restored. | |
| coverage | No | Percent of the site the last run reached; under 90 means removals are withheld. | |
| settings | No | No project_id only: every common setting as {key, meaning, default}. | |
| webhooks | No | get_project only: {url, events, deliveries}: where run and change events are POSTed, which events, and the last 10 deliveries, each {id, event, status (queued, retrying, delivered or failed), attempts, lastStatus, lastError, createdAt, deliveredAt}. The signing secret is never included. | |
| lastRunAt | No | When the last run started (ISO 8601), or null. | |
| nextRunAt | No | When the schedule runs it next, or null for manual. | |
| retention | No | How long runs are kept, e.g. '90d'. | |
| schedules | No | No project_id only: the valid schedules. | |
| archivedAt | No | When it was archived (ISO 8601), or null. | |
| configNote | No | create_project and update_project only: says that config lists only the non-default settings. | |
| other_keys | No | No project_id only: further keys accepted but rarely needed. | |
| scheduleKey | No | manual, hourly, daily or weekly. | |
| webhookTest | No | update_project with test_webhook only: {queued, id} when a test run.finished message was queued, or {error, status} when the API refused it, e.g. with no webhook URL saved. | |
| changeSummary | No | The last compared run in words, e.g. '3 new · 2 changed · 0 removed'. |