Spala Public MCP

Returns a human-readable overview of Spala, canonical start URLs, and the boundary between public discovery and project-scoped backend MCPs. Invoke for product, setup, or integration orientation. This read-only tool requires no authentication and does not access or modify project data.

{
  "type": "object",
  "properties": {},
  "description": "No arguments. Call this tool with an empty object.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "markdown": {
      "type": "string"
    }
  },
  "required": [
    "markdown"
  ],
  "description": "Human-readable Spala overview and public/project MCP boundary.",
  "additionalProperties": true
}

Returns machine-readable Spala onboarding information for MCP clients. Includes product scope, OAuth metadata, supported installer client identifiers, authenticated project-handoff status, workflow stages, and canonical links.

{
  "type": "object",
  "properties": {},
  "description": "No arguments. Call this tool with an empty object.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string"
    },
    "publicMcpRole": {
      "type": "string"
    },
    "projectMcpRole": {
      "type": "string"
    },
    "intentBoundary": {
      "type": "object",
      "additionalProperties": true
    },
    "workflow": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "supportedInstallerClients": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "urls": {
      "type": "object",
      "additionalProperties": true
    },
    "handoffExample": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "required": [
    "product",
    "publicMcpRole",
    "projectMcpRole",
    "workflow",
    "urls"
  ],
  "description": "Anonymous compatibility onboarding and canonical Spala workflow links.",
  "additionalProperties": true
}

Returns a machine-readable routing map for Spala MCP clients. Identifies public and authenticated tools, supported installer clients, OAuth endpoints, project handoff rules, and project-MCP entry points.

{
  "type": "object",
  "properties": {},
  "description": "No arguments. Call this tool with an empty object.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "publicMcp": {
      "type": "object",
      "additionalProperties": true
    },
    "projectMcp": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "required": [
    "publicMcp",
    "projectMcp"
  ],
  "description": "Machine-readable routing map for the public MCP and project MCP.",
  "additionalProperties": true
}

Searches the public Spala agent-facing documentation index by query. Invoke for setup, OAuth, installer, public-versus-project MCP, pricing, limits, security, templates, addons, or project handoff questions. Returns ranked docs entries with URLs and summaries.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional search phrase. Use words such as auth, OAuth, MCP, templates, addons, pricing, limits, frontend handoff, or project handoff.",
      "default": ""
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Maximum number of ranked documentation results to return.",
      "default": 5
    }
  },
  "description": "Optional text search and result limit for public Spala documentation.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    }
  },
  "required": [
    "query",
    "results"
  ],
  "description": "Ranked public documentation search results.",
  "additionalProperties": true
}

Lists public Spala backend templates matching an optional query. Invoke to discover available backend starting points such as marketplace, dashboard API, reservation, inventory, or document management. Returns template ids, names, descriptions, and tags.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional filter phrase for matching public Spala templates or addons by name, tag, or use case.",
      "default": ""
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Maximum number of catalog entries to return.",
      "default": 20
    }
  },
  "description": "Optional catalog search and result limit for public Spala planning resources.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "templates": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    }
  },
  "required": [
    "query",
    "templates"
  ],
  "description": "Public Spala backend templates matching the optional query.",
  "additionalProperties": true
}

Lists public Spala addons and integrations matching an optional query. Invoke to discover capabilities such as webhooks, outbound HTTP API calls, transactional email, media uploads, and realtime messaging. Returns addon ids, names, descriptions, and tags.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional filter phrase for matching public Spala templates or addons by name, tag, or use case.",
      "default": ""
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Maximum number of catalog entries to return.",
      "default": 20
    }
  },
  "description": "Optional catalog search and result limit for public Spala planning resources.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "addons": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    }
  },
  "required": [
    "query",
    "addons"
  ],
  "description": "Public Spala addons and integrations matching the optional query.",
  "additionalProperties": true
}

AUTH REQUIRED; READ-ONLY STARTUP. Invoke after OAuth to begin Spala account or project setup. Returns a versioned startup phase with account readiness, organizations, safely scoped project discovery, and one explicit next action. Reports missing account fields, automatically scopes a sole organization, and returns all accessible choices when multiple organizations exist.

{
  "type": "object",
  "properties": {},
  "description": "No arguments. Call this tool with an empty object.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "integer"
    },
    "phase": {
      "type": "string"
    },
    "authenticated": {
      "type": "boolean"
    },
    "backendProvider": {
      "type": "string"
    },
    "user": {
      "type": "object",
      "additionalProperties": true
    },
    "accountSetup": {
      "type": "object",
      "additionalProperties": true
    },
    "selectedOrganizationId": {
      "type": "string"
    },
    "organizations": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "projects": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "installerMaintenance": {
      "type": "object",
      "additionalProperties": true
    },
    "nextAction": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "required": [
    "schemaVersion",
    "phase",
    "authenticated",
    "backendProvider",
    "user",
    "accountSetup",
    "organizations",
    "projects",
    "installerMaintenance",
    "nextAction"
  ],
  "description": "Authenticated startup state with account readiness, project discovery, and one next action.",
  "additionalProperties": true
}

AUTH REQUIRED; READ-ONLY. Verifies the current public MCP OAuth identity and account readiness. Returns the authenticated identity, available organizations, and exact missing account fields without exposing OAuth or dashboard credentials.

{
  "type": "object",
  "properties": {},
  "description": "No arguments. Call this tool with an empty object.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "authenticated": {
      "type": "boolean"
    },
    "tokenStatus": {
      "type": "string"
    },
    "oauthResource": {
      "type": "string"
    },
    "subject": {
      "type": "string"
    },
    "user": {
      "type": "object",
      "additionalProperties": true
    },
    "organizations": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "accountSetup": {
      "type": "object",
      "additionalProperties": true
    },
    "next": {
      "type": "string"
    }
  },
  "required": [
    "authenticated",
    "tokenStatus",
    "oauthResource",
    "subject",
    "user",
    "organizations",
    "accountSetup"
  ],
  "description": "Authenticated Spala account readiness and organization state.",
  "additionalProperties": true
}

AUTH REQUIRED; WRITES MISSING ACCOUNT DATA TO THE SPALA CONTROL PLANE. Fills missing first and last name fields and creates the first company or workspace organization when none exists. Invoke only with real account and organization values supplied by the user.

{
  "type": "object",
  "properties": {
    "firstName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Account holder first name. Required when account_status reports firstName missing."
    },
    "lastName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Account holder last name. Required when account_status reports lastName missing."
    },
    "companyName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Company or workspace name. Required when account_status reports companyName missing."
    }
  },
  "description": "Complete missing Spala account data after OAuth. Supply only real values confirmed by the user or confidently known from the current work context.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "accountSetup": {
      "type": "string"
    },
    "profileUpdated": {
      "type": "boolean"
    },
    "organizationCreated": {
      "type": "boolean"
    },
    "user": {
      "type": "object",
      "additionalProperties": true
    },
    "organization": {
      "type": "object",
      "additionalProperties": true
    },
    "nextAction": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "required": [
    "accountSetup",
    "profileUpdated",
    "organizationCreated",
    "user",
    "organization",
    "nextAction"
  ],
  "description": "Completed account setup and the next protected startup action.",
  "additionalProperties": true
}

AUTH REQUIRED; WRITES A NEW SPALA ORGANIZATION FOR THE SIGNED-IN ACCOUNT. Creates an additional company or workspace organization using the supplied name.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Human-readable company or workspace name."
    }
  },
  "required": [
    "name"
  ],
  "description": "Create an additional Spala organization for the authenticated account.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "organization": {
      "type": "object",
      "additionalProperties": true
    },
    "created": {
      "type": "boolean"
    },
    "nextAction": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "required": [
    "organization",
    "created",
    "nextAction"
  ],
  "description": "New Spala organization and the next startup action.",
  "additionalProperties": true
}

AUTH REQUIRED; READ-ONLY. Lists projects accessible to the authenticated Spala user in one organization. Accepts an organization id when multiple organizations are available and automatically scopes a sole organization.

{
  "type": "object",
  "properties": {
    "organizationId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Organization ID returned for the signed-in account. Optional only when exactly one organization is available."
    }
  },
  "description": "List projects for an organization available to the authenticated user.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "organization": {
      "type": "object",
      "additionalProperties": true
    },
    "projects": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    }
  },
  "required": [
    "organization",
    "projects"
  ],
  "description": "Projects in one authoritative organization available to the authenticated user.",
  "additionalProperties": true
}

AUTH REQUIRED; WRITES TO THE SPALA CONTROL PLANE. Creates a real Spala project with the supplied project name in an accessible organization. Accepts an organization id when multiple organizations are available and automatically scopes a sole organization. This operation is not idempotent.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Human-readable name for the new Spala project."
    },
    "organizationId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Organization ID returned for the signed-in account. Optional only when exactly one organization is available."
    }
  },
  "required": [
    "name"
  ],
  "description": "Create a real Spala project in an organization available to the authenticated user.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "organization": {
      "type": "object",
      "additionalProperties": true
    },
    "project": {
      "type": "object",
      "additionalProperties": true
    },
    "created": {
      "type": "boolean"
    },
    "mcpUrlResolved": {
      "type": "boolean"
    },
    "provisioning": {
      "type": "object",
      "additionalProperties": true
    },
    "next": {
      "type": "string"
    }
  },
  "required": [
    "organization",
    "project",
    "created",
    "mcpUrlResolved",
    "provisioning",
    "next"
  ],
  "description": "New Spala project and provisioning guidance for project MCP handoff.",
  "additionalProperties": true
}

AUTH REQUIRED; IDEMPOTENT PROJECT CONNECTION WRITE. Prepares one accessible Spala project for agent access. Accepts one installer client (codex, roo, claude-code, cursor, a2a); when omitted, returns a client-selection response without executable arguments. Returns a client-specific workspace binding plan: protected one-time bootstrap for Codex, Roo, and Cursor; verifier-bound delegated bootstrap for Claude Code.

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Exact Spala project ID. Mutually exclusive with subdomain."
    },
    "subdomain": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Exact project subdomain returned by the Spala projects API. Mutually exclusive with projectId."
    },
    "organizationId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Optional organization ID returned for the signed-in account."
    },
    "client": {
      "type": "string",
      "enum": [
        "codex",
        "roo",
        "claude-code",
        "cursor",
        "a2a"
      ],
      "description": "Target MCP client for @spala-ai/mcp-install. Omit to receive client_selection_required without an executable mutation plan."
    },
    "profile": {
      "type": "string",
      "enum": [
        "guided"
      ],
      "description": "Set to guided to preserve the compact build-and-test surface through project handoff. Omit for the default full compatibility surface."
    },
    "bootstrapRequestId": {
      "type": "string",
      "pattern": "^claim_[A-Za-z0-9_-]{20,80}$",
      "description": "Non-secret local request ID returned by project prepare. Claude Code only."
    },
    "bootstrapChallenge": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{43}$",
      "description": "S256 challenge returned by project prepare. The verifier remains only in the local credential store."
    }
  },
  "description": "Provide exactly one project selector and a supported agentic workspace client (codex, roo, claude-code, or cursor) to receive executable installer argv.",
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "projectId"
      ],
      "properties": {
        "projectId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256,
          "description": "Exact Spala project ID. Mutually exclusive with subdomain."
        },
        "client": {
          "type": "string",
          "enum": [
            "codex",
            "roo",
            "claude-code",
            "cursor",
            "a2a"
          ],
          "description": "Target MCP client for @spala-ai/mcp-install. Omit to receive client_selection_required without an executable mutation plan."
        },
        "profile": {
          "type": "string",
          "enum": [
            "guided"
          ],
          "description": "Set to guided to preserve the compact build-and-test surface through project handoff. Omit for the default full compatibility surface."
        },
        "bootstrapRequestId": {
          "type": "string",
          "pattern": "^claim_[A-Za-z0-9_-]{20,80}$",
          "description": "Non-secret local request ID returned by project prepare. Claude Code only."
        },
        "bootstrapChallenge": {
          "type": "string",
          "pattern": "^[A-Za-z0-9_-]{43}$",
          "description": "S256 challenge returned by project prepare. The verifier remains only in the local credential store."
        }
      }
    },
    {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "subdomain"
      ],
      "properties": {
        "subdomain": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256,
          "description": "Exact project subdomain returned by the Spala projects API. Mutually exclusive with projectId."
        },
        "organizationId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256,
          "description": "Optional organization ID returned for the signed-in account."
        },
        "client": {
          "type": "string",
          "enum": [
            "codex",
            "roo",
            "claude-code",
            "cursor",
            "a2a"
          ],
          "description": "Target MCP client for @spala-ai/mcp-install. Omit to receive client_selection_required without an executable mutation plan."
        },
        "profile": {
          "type": "string",
          "enum": [
            "guided"
          ],
          "description": "Set to guided to preserve the compact build-and-test surface through project handoff. Omit for the default full compatibility surface."
        },
        "bootstrapRequestId": {
          "type": "string",
          "pattern": "^claim_[A-Za-z0-9_-]{20,80}$",
          "description": "Non-secret local request ID returned by project prepare. Claude Code only."
        },
        "bootstrapChallenge": {
          "type": "string",
          "pattern": "^[A-Za-z0-9_-]{43}$",
          "description": "S256 challenge returned by project prepare. The verifier remains only in the local credential store."
        }
      }
    }
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "project": {
      "type": "object",
      "additionalProperties": true
    },
    "handoff": {
      "type": "object",
      "additionalProperties": true
    },
    "mcpUrl": {
      "type": "string",
      "format": "uri"
    },
    "toolProfile": {
      "type": "string",
      "enum": [
        "full",
        "guided"
      ]
    },
    "serverName": {
      "type": "string"
    },
    "transport": {
      "type": "string"
    },
    "preparedByProjectBackend": {
      "type": "boolean"
    },
    "bootstrapPreparedByProjectBackend": {
      "type": "boolean"
    },
    "workspaceOnly": {
      "type": "boolean"
    },
    "installPlan": {
      "type": "object",
      "additionalProperties": true
    },
    "bootstrap": {
      "type": "object",
      "additionalProperties": true
    },
    "nextSteps": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "intentBoundary": {
      "type": "object",
      "additionalProperties": true
    },
    "rule": {
      "type": "string"
    }
  },
  "required": [
    "project",
    "handoff",
    "mcpUrl",
    "serverName",
    "transport",
    "installPlan",
    "bootstrap"
  ],
  "description": "Prepared project MCP connection and workspace-only installer handoff.",
  "additionalProperties": true
}

AUTH REQUIRED; IDEMPOTENT PROJECT CONNECTION WRITE. Compatibility alias for project_connect. Prepares one accessible project and returns the same client-specific workspace binding contract as project_connect.

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Exact Spala project ID. Mutually exclusive with subdomain."
    },
    "subdomain": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Exact project subdomain returned by the Spala projects API. Mutually exclusive with projectId."
    },
    "organizationId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Optional organization ID returned for the signed-in account."
    },
    "client": {
      "type": "string",
      "enum": [
        "codex",
        "roo",
        "claude-code",
        "cursor",
        "a2a"
      ],
      "description": "Target MCP client for @spala-ai/mcp-install. Omit to receive client_selection_required without an executable mutation plan."
    },
    "profile": {
      "type": "string",
      "enum": [
        "guided"
      ],
      "description": "Set to guided to preserve the compact build-and-test surface through project handoff. Omit for the default full compatibility surface."
    },
    "bootstrapRequestId": {
      "type": "string",
      "pattern": "^claim_[A-Za-z0-9_-]{20,80}$",
      "description": "Non-secret local request ID returned by project prepare. Claude Code only."
    },
    "bootstrapChallenge": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{43}$",
      "description": "S256 challenge returned by project prepare. The verifier remains only in the local credential store."
    }
  },
  "description": "Provide exactly one project selector and a supported agentic workspace client (codex, roo, claude-code, or cursor) to receive executable installer argv.",
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "projectId"
      ],
      "properties": {
        "projectId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256,
          "description": "Exact Spala project ID. Mutually exclusive with subdomain."
        },
        "client": {
          "type": "string",
          "enum": [
            "codex",
            "roo",
            "claude-code",
            "cursor",
            "a2a"
          ],
          "description": "Target MCP client for @spala-ai/mcp-install. Omit to receive client_selection_required without an executable mutation plan."
        },
        "profile": {
          "type": "string",
          "enum": [
            "guided"
          ],
          "description": "Set to guided to preserve the compact build-and-test surface through project handoff. Omit for the default full compatibility surface."
        },
        "bootstrapRequestId": {
          "type": "string",
          "pattern": "^claim_[A-Za-z0-9_-]{20,80}$",
          "description": "Non-secret local request ID returned by project prepare. Claude Code only."
        },
        "bootstrapChallenge": {
          "type": "string",
          "pattern": "^[A-Za-z0-9_-]{43}$",
          "description": "S256 challenge returned by project prepare. The verifier remains only in the local credential store."
        }
      }
    },
    {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "subdomain"
      ],
      "properties": {
        "subdomain": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256,
          "description": "Exact project subdomain returned by the Spala projects API. Mutually exclusive with projectId."
        },
        "organizationId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256,
          "description": "Optional organization ID returned for the signed-in account."
        },
        "client": {
          "type": "string",
          "enum": [
            "codex",
            "roo",
            "claude-code",
            "cursor",
            "a2a"
          ],
          "description": "Target MCP client for @spala-ai/mcp-install. Omit to receive client_selection_required without an executable mutation plan."
        },
        "profile": {
          "type": "string",
          "enum": [
            "guided"
          ],
          "description": "Set to guided to preserve the compact build-and-test surface through project handoff. Omit for the default full compatibility surface."
        },
        "bootstrapRequestId": {
          "type": "string",
          "pattern": "^claim_[A-Za-z0-9_-]{20,80}$",
          "description": "Non-secret local request ID returned by project prepare. Claude Code only."
        },
        "bootstrapChallenge": {
          "type": "string",
          "pattern": "^[A-Za-z0-9_-]{43}$",
          "description": "S256 challenge returned by project prepare. The verifier remains only in the local credential store."
        }
      }
    }
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "project": {
      "type": "object",
      "additionalProperties": true
    },
    "handoff": {
      "type": "object",
      "additionalProperties": true
    },
    "mcpUrl": {
      "type": "string",
      "format": "uri"
    },
    "toolProfile": {
      "type": "string",
      "enum": [
        "full",
        "guided"
      ]
    },
    "serverName": {
      "type": "string"
    },
    "transport": {
      "type": "string"
    },
    "preparedByProjectBackend": {
      "type": "boolean"
    },
    "bootstrapPreparedByProjectBackend": {
      "type": "boolean"
    },
    "workspaceOnly": {
      "type": "boolean"
    },
    "installPlan": {
      "type": "object",
      "additionalProperties": true
    },
    "bootstrap": {
      "type": "object",
      "additionalProperties": true
    },
    "nextSteps": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "intentBoundary": {
      "type": "object",
      "additionalProperties": true
    },
    "rule": {
      "type": "string"
    }
  },
  "required": [
    "project",
    "handoff",
    "mcpUrl",
    "serverName",
    "transport",
    "installPlan",
    "bootstrap"
  ],
  "description": "Prepared project MCP connection and workspace-only installer handoff.",
  "additionalProperties": true
}

AUTH REQUIRED; IDEMPOTENT PROJECT CONNECTION WRITE. Prepares one accessible project and returns its exact platform-provided project MCP manifest URL, MCP URL, and client-specific workspace binding plan. Accepts one installer client (codex, roo, claude-code, cursor, a2a); when omitted, returns a client-selection response without executable arguments.

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Exact Spala project ID. Mutually exclusive with subdomain."
    },
    "subdomain": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Exact project subdomain returned by the Spala projects API. Mutually exclusive with projectId."
    },
    "organizationId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Optional organization ID returned for the signed-in account."
    },
    "client": {
      "type": "string",
      "enum": [
        "codex",
        "roo",
        "claude-code",
        "cursor",
        "a2a"
      ],
      "description": "Target MCP client for @spala-ai/mcp-install. Omit to receive client_selection_required without an executable mutation plan."
    },
    "profile": {
      "type": "string",
      "enum": [
        "guided"
      ],
      "description": "Set to guided to preserve the compact build-and-test surface through project handoff. Omit for the default full compatibility surface."
    },
    "bootstrapRequestId": {
      "type": "string",
      "pattern": "^claim_[A-Za-z0-9_-]{20,80}$",
      "description": "Non-secret local request ID returned by project prepare. Claude Code only."
    },
    "bootstrapChallenge": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{43}$",
      "description": "S256 challenge returned by project prepare. The verifier remains only in the local credential store."
    }
  },
  "description": "Provide exactly one project selector and a supported agentic workspace client (codex, roo, claude-code, or cursor) to receive executable installer argv.",
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "projectId"
      ],
      "properties": {
        "projectId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256,
          "description": "Exact Spala project ID. Mutually exclusive with subdomain."
        },
        "client": {
          "type": "string",
          "enum": [
            "codex",
            "roo",
            "claude-code",
            "cursor",
            "a2a"
          ],
          "description": "Target MCP client for @spala-ai/mcp-install. Omit to receive client_selection_required without an executable mutation plan."
        },
        "profile": {
          "type": "string",
          "enum": [
            "guided"
          ],
          "description": "Set to guided to preserve the compact build-and-test surface through project handoff. Omit for the default full compatibility surface."
        },
        "bootstrapRequestId": {
          "type": "string",
          "pattern": "^claim_[A-Za-z0-9_-]{20,80}$",
          "description": "Non-secret local request ID returned by project prepare. Claude Code only."
        },
        "bootstrapChallenge": {
          "type": "string",
          "pattern": "^[A-Za-z0-9_-]{43}$",
          "description": "S256 challenge returned by project prepare. The verifier remains only in the local credential store."
        }
      }
    },
    {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "subdomain"
      ],
      "properties": {
        "subdomain": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256,
          "description": "Exact project subdomain returned by the Spala projects API. Mutually exclusive with projectId."
        },
        "organizationId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256,
          "description": "Optional organization ID returned for the signed-in account."
        },
        "client": {
          "type": "string",
          "enum": [
            "codex",
            "roo",
            "claude-code",
            "cursor",
            "a2a"
          ],
          "description": "Target MCP client for @spala-ai/mcp-install. Omit to receive client_selection_required without an executable mutation plan."
        },
        "profile": {
          "type": "string",
          "enum": [
            "guided"
          ],
          "description": "Set to guided to preserve the compact build-and-test surface through project handoff. Omit for the default full compatibility surface."
        },
        "bootstrapRequestId": {
          "type": "string",
          "pattern": "^claim_[A-Za-z0-9_-]{20,80}$",
          "description": "Non-secret local request ID returned by project prepare. Claude Code only."
        },
        "bootstrapChallenge": {
          "type": "string",
          "pattern": "^[A-Za-z0-9_-]{43}$",
          "description": "S256 challenge returned by project prepare. The verifier remains only in the local credential store."
        }
      }
    }
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "integer"
    },
    "name": {
      "type": "string"
    },
    "project": {
      "type": "object",
      "additionalProperties": true
    },
    "handoff": {
      "type": "object",
      "additionalProperties": true
    },
    "mcpUrl": {
      "type": "string",
      "format": "uri"
    },
    "manifestUrl": {
      "type": "string",
      "format": "uri"
    },
    "toolProfile": {
      "type": "string",
      "enum": [
        "full",
        "guided"
      ]
    },
    "serverName": {
      "type": "string"
    },
    "transport": {
      "type": "string"
    },
    "auth": {
      "type": "string"
    },
    "installPlan": {
      "type": "object",
      "additionalProperties": true
    },
    "bootstrap": {
      "type": "object",
      "additionalProperties": true
    },
    "nextSteps": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "intentBoundary": {
      "type": "object",
      "additionalProperties": true
    },
    "rule": {
      "type": "string"
    }
  },
  "required": [
    "schemaVersion",
    "name",
    "project",
    "handoff",
    "mcpUrl",
    "manifestUrl",
    "serverName",
    "transport",
    "installPlan",
    "bootstrap"
  ],
  "description": "Prepared project MCP manifest, exact URLs, and workspace-only installer handoff.",
  "additionalProperties": true
}

AUTH REQUIRED; READ-ONLY. Returns documented MCP handoff fields for one accessible project without exposing tokens, private source code, unrelated customer data, or executable installer arguments.

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Exact Spala project ID. Mutually exclusive with subdomain."
    },
    "subdomain": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Exact project subdomain returned by the Spala projects API. Mutually exclusive with projectId."
    },
    "organizationId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Optional organization ID returned for the signed-in account."
    }
  },
  "description": "Provide exactly one project selector: projectId or subdomain. organizationId is optional when selecting by subdomain.",
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "projectId"
      ],
      "properties": {
        "projectId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256,
          "description": "Exact Spala project ID. Mutually exclusive with subdomain."
        }
      }
    },
    {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "subdomain"
      ],
      "properties": {
        "subdomain": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256,
          "description": "Exact project subdomain returned by the Spala projects API. Mutually exclusive with projectId."
        },
        "organizationId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256,
          "description": "Optional organization ID returned for the signed-in account."
        }
      }
    }
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "project": {
      "type": "object",
      "additionalProperties": true
    },
    "intentBoundary": {
      "type": "object",
      "additionalProperties": true
    },
    "handoff": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "required": [
    "project",
    "intentBoundary",
    "handoff"
  ],
  "description": "Safe documented project handoff context without credentials or executable installer arguments.",
  "additionalProperties": true
}