Browse the documentation

MCP server

MCP server

The Layerz MCP server gives AI agents the full model, read and write, through tools and reference resources, signed in with OAuth or an API key.

The Model Context Protocol server is how an AI agent works a Layerz model. It exposes 29 tools and 5 resources at:

https://layerz.cc/mcp

Connecting

  • OAuth (recommended): the client registers itself, the user signs in to Layerz and approves the access. Every client listed in Quickstart with an AI agent works this way.
  • API key: a client that cannot do OAuth sends Authorization: Bearer lz_.... A key can be limited to one model and to read-only; the server then hides the tools the key cannot use.

What an agent can do

ToolWhat it does
layerz_build_from_blueprintBuild from blueprint
layerz_create_modelCreate model
layerz_create_upload_urlCreate file upload URL
layerz_delete_branchDelete branch
layerz_dependenciesTrace dependencies
layerz_diffDiff two versions
layerz_exportExport to file
layerz_external_refLink, refresh or unlink external reference
layerz_get_conventionsGet conventions
layerz_get_modelGet model detail
layerz_historyList version history
layerz_import_branchImport data into branch
layerz_list_integrationsList data sources
layerz_list_mappingsList mapping rules
layerz_list_modelsList models
layerz_list_templatesList templates
layerz_list_transactionsList staged transactions
layerz_manage_integrationSync, configure or delete data source
layerz_manage_mappingSet, delete or import mapping rules
layerz_manage_versionPin, unpin or restore version
layerz_match_itemsMatch labels to items
layerz_parse_fileParse uploaded file
layerz_patchApply model patch
layerz_readRead model snapshot
layerz_set_custom_instructionsSet custom instructions
layerz_set_finance_mdSet FINANCE.md
layerz_share_modelInvite or revoke model access
layerz_update_branchCreate or update branch
layerz_validate_modelValidate model

Resources

ResourceContent
modeling-guide://referenceThe modeling guide: the session workflow, structure and modelling patterns, validated patch examples. Also on this site.
formula-spec://referenceThe formula language.
format-spec://referenceThe number formats.
finance-md://model/{model_id}A model's FINANCE.md.
custom-instructions://userThe conventions of the personal workspace.

Conventions come first

Every model opened through the server comes back with conventions: the workspace conventions and the model's FINANCE.md. They say how to read the numbers (currency, units, signs) and how this team models. Agents read them before their first write; see Session workflow.

Safety

  • Tools carry standard annotations (read-only, destructive, idempotent), so a client can ask for confirmation before a destructive call.
  • Every write records a version labelled with the agent's summary; any change can be compared and restored.
  • Connector credentials never transit through MCP.