@typeroll/mcp-server 0.45.109 → 0.45.111
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +11 -0
- package/README.md +1 -1
- package/dist/bundled-content.js +3 -3
- package/dist/rest-reference.js +200 -0
- package/dist/server.js +38 -34
- package/dist/tools/deploy.js +1 -1
- package/dist/tools/domain.js +1 -1
- package/dist/tools/forms.js +21 -0
- package/dist/tools/media.js +1 -1
- package/dist/version.js +1 -1
- package/package.json +3 -2
- package/skills/tr-forms.md +5 -0
package/AGENTS.md
CHANGED
|
@@ -1346,6 +1346,7 @@ preview.
|
|
|
1346
1346
|
| **Redirects** | `list_redirects`, `create_redirect`, `delete_redirect`. `from_path` may be a PATTERN: a trailing `*` (with `:splat` in the target) or `:name` for one segment — one rule retires a whole family of dead URLs (`/category/*` → `/blogg/:splat`). Mid-path splats and query strings are refused, as is any rule that would hide a live page. |
|
|
1347
1347
|
| **Migration inventory + launch gate** | `get_migration_readiness` (preflight — CALL FIRST), `list_migration_urls`, `add_migration_urls`, `update_migration_url`, `update_migration_urls`, `delete_migration_url`, `import_sitemap`, `import_gsc_performance`, `repair_migration_plain_text`, `verify_migration_urls`, `record_migration_seo_acceptance`, `get_migration_launch_report`. Sitemap indexes are recursive. GSC supports direct Search Console access or CSV and aggregates fragment variants. Plain-text repair is allowlisted and dry-run-first. A complete unfiltered URL check and reviewed SEO evidence are bound to the latest hosted deploy; the launch report fails closed when either is stale or incomplete. |
|
|
1348
1348
|
| **Forms** | `list_forms`, `read_form`, `create_form`, `update_form`, `delete_form`, `get_form_capabilities`, `list_form_submissions`, `read_form_submission`, `delete_form_submission` (removes one submission — e.g. cleaning up a test entry; `delete_form` with `delete_submissions` is the bulk path). **Steps (form/* block trees) are the ONLY stored model**: pass `steps` for funnels, or `fields` for simple forms — the server converts a flat field list to a single static step. Place with a `core/form` block on block-mode pages or `<x-form id="…" />` in HTML mode. Both expand server-side to the same complete signed shell and initial state. `read_form` shows the form's actions (email notifications, webhooks; secrets masked) and `create_form`/`update_form` set them with `actions`, with admin permission as in the portal; `get_form_capabilities` lists the action types (including app-provided ones) and their config fields. |
|
|
1349
|
+
| **Form spam protection (admin)** | `get_form_spam_protection`, `set_form_spam_protection`, `delete_form_spam_protection` — Cloudflare Turnstile for every form on the site: the site owner creates a Managed widget in their Cloudflare dashboard, you store its site key and secret (write-only), then publish. Each form requires Turnstile after its republished pages send the first verified answer (`enforced_forms`). App and Extension forms are not covered. |
|
|
1349
1350
|
| **Email (admin)** | `get_email_settings`, `set_email_settings`, `delete_email_settings`, `send_test_email` — the outgoing provider (Postmark, SMTP, SES) that form notifications send through, as in Settings → Email & notifications; secrets are write-only (reads show `{ set: true }`; omit a secret to keep it). Without a provider, form email actions are skipped. `get_incoming_email_settings`, `set_incoming_email_forwarding` (enable/disable a host-approved route by `route_id` + current `revision`; cannot create aliases or change targets), `read_incoming_email_receipt`. |
|
|
1350
1351
|
| **Settings** | `update_site_settings` (admin; every field the portal Settings form accepts, including `sitewide_noindex`, `default_og_image`, `twitter_handle`, `organization`, `staging_url` and shallow-merged native `cookie_consent`), `check_site_indexing` (live fallback/production headers, meta robots, and robots.txt diagnostics) |
|
|
1351
1352
|
| **Core modules** | `list_apps`, `read_app`, `update_app` (legacy API name; admin; schema-driven config, masked secrets, redeploy when `affects_build` is true); `list_organization_analytics`, `set_organization_analytics` (Analytics for chosen Sites; organization key) |
|
|
@@ -1476,3 +1477,13 @@ with `read_site_instructions` and enabled App guides with
|
|
|
1476
1477
|
`read_app_documentation`. Use `tr-edit-site` for the editor workflow.
|
|
1477
1478
|
Organization administration requires an explicit `organization_id` and a
|
|
1478
1479
|
current owner/admin membership. Manual API keys keep their existing scope.
|
|
1480
|
+
|
|
1481
|
+
## REST parity
|
|
1482
|
+
|
|
1483
|
+
Every tool must call the REST API through `TyperollClient`; a tool must not do
|
|
1484
|
+
work the API cannot. The published REST reference
|
|
1485
|
+
(`packages/docs-site/src/content/docs/technical/rest-api-reference.md`) is
|
|
1486
|
+
generated from the tools by `npm run gen:rest` (also part of `npm run gen`), and
|
|
1487
|
+
`tests/rest-reference.test.ts` fails when it is stale or a tool makes no REST
|
|
1488
|
+
call. Tools that only read bundled documentation are listed in `LOCAL_TOOLS`.
|
|
1489
|
+
|
package/README.md
CHANGED
|
@@ -52,7 +52,7 @@ release. See the [model guide](https://typeroll.com/docs/tools/content-types/) a
|
|
|
52
52
|
personal access with any role. No API key copying is needed. Confirm a site
|
|
53
53
|
and version, use `select_site`, and carry its `site_context` on site calls.
|
|
54
54
|
Revoke access in Account → AI connections. Permissions are checked live;
|
|
55
|
-
the connection
|
|
55
|
+
the connection lasts until revoked. Legacy OAuth grants remain scoped
|
|
56
56
|
as before until reconnecting. Manual bearer keys remain supported.
|
|
57
57
|
- **Local stdio — launch the npm package.** Use a client that can run a local
|
|
58
58
|
command with environment variables. Instructions below.
|