MCP Tool Reference
The Typeroll MCP server gives the AI agent a complete toolkit for managing sites. Your agent selects tools based on your instructions. You can also build your own integration with the authenticated API.
Tool categories
Section titled “Tool categories”| Category | Tools | What they do |
|---|---|---|
| Pages | create_page, read_page, update_page, list_pages, batch_update_pages, batch_read_pages, search_pages, delete_page, set_page_mode, convert_page_to_blocks |
Create and edit pages (HTML- or block-mode) |
| Blocks | get_page_blocks, add_block, update_block, move_block, remove_block, duplicate_block, set_block_responsive, list_block_types, read_block_type, create_block_type, update_block_type, delete_block_type, find_pages_using_block_type, export_block_types, import_block_types |
Compose pages/partials/templates from ~40 reusable blocks; author custom block types |
| Partials | read_partial, replace_partial, list_partials |
Header, footer and shared HTML fragments (HTML- or block-mode) |
| Settings | read_site_settings, update_site_settings, get_site, list_sites |
Site-wide config: colours, fonts, domain |
| Collections | create_collection, read_collection, list_collections, create_collection_item, read_collection_item, update_collection_item, list_collection_items, delete_collection_item |
Structured content: blog posts, team members, products. Item layouts can be block trees (item_template_blocks) |
| Page templates | list_page_templates, set_page_template |
Assign a PageTemplate to a page; edit templates via the block tools with target: { kind: 'template', id } |
| Forms | create_form, read_form, update_form, list_forms, delete_form |
Contact and booking forms |
| Media | upload_media_from_url, upload_media_from_base64, list_media |
Images and other media assets |
| Redirects | create_redirect, list_redirects, delete_redirect |
URL redirects |
| Migration URLs | list_migration_urls, add_migration_urls, update_migration_url, delete_migration_url, repair_migration_plain_text, verify_migration_urls |
Track every URL the old site had, repair legacy WordPress text, and prove the new one answers before DNS moves |
| Deploy | trigger_deploy, get_deploy_status, get_preview_link |
Build and deploy the site |
How tools are selected
Section titled “How tools are selected”The AI agent picks tools based on context. You never need to say “call create_page” — just describe what you want:
“Add a Services page with three service cards” → the AI agent calls
create_page
“Update the nav to include the new Services link” → the AI agent calls
read_partial, thenreplace_partial
“Deploy it” → the AI agent calls
trigger_deploy, then pollsget_deploy_status
Authentication
Section titled “Authentication”All tool calls go through the MCP server, which forwards your TYPEROLL_API_KEY to the portal API. Organization and site keys have different scopes; each call is limited to the sites and operations the key permits.
Rate limits
Section titled “Rate limits”The portal API is rate-limited per API key. For large batch operations (importing many pages, bulk SEO updates), the AI agent uses batch_update_pages to stay within limits.