Model Context Protocol (MCP v1)

Connect your local agents directly to the Landi engine. We expose 98 manifest actions wrapped into clean, named aliases for seamless LLM consumption.

Named Aliases

Alias	Description
landi_generate_site	Initiate SITE_PAGE_GENERATOR_WORKFLOW.
landi_generate_page	Append page to existing virtual filesystem.
landi_publish_site	Deploy draft to Edge Workers.
landi_create_collection	Instantiate data schema structure.
landi_restore_version	Rollback HTML to specific commit hash.
landi_deep_research	Run expensive competitor analysis (needs confirm).
landi_analyze_site_compatibility	Ext-01: Score raw HTML for import.
landi_site_conversion_guidance	Ext-01: Get fix instructions by sourceType.
landi_import_site	Ext-01: Ingest via prepare-html-for-editor.

Generic Tools & Orchestration

Fallback to base generic tools when a named alias isn't sufficient:

landi_query
landi_mutate
landi_job_status
landi_describe

Orchestrate via Workflow YAML using the landi-orchestrator MCP.
(Note: tools only validate and register; execution requires explicit request):

validate_workflow_yaml
register_workflow_yaml

Configuration & Errors

Sample ~/.cursor/mcp.json setup connecting to your Landi servers:

{
  "mcpServers": {
    "user-landi": {
      "command": "npx",
      "args": ["@landi-build/mcp-server"]
    },
    "user-landi-nas": {
      "command": "npx",
      "args": ["@landi-build/mcp-server", "--nas-mode"]
    }
  }
}

Common Error Codes to handle in your agents:

SCOPE_MISSING Missing API key or workspace ID.

NEEDS_CONFIRM DryRun completed. Awaiting user approval to execute.

JOB_PENDING Async task queued. Poll with landi_job_status.

RATE_LIMITED Too many expensive requests per minute.