AI Agents & MCP

Connect AI coding agents to Spala through the public MCP, authenticate with Spala, select a project, and hand off to the project MCP.

AI Agents & MCP

Spala exposes a public MCP endpoint for AI coding agents that need to discover Spala, authenticate with the Spala platform, select a project, and hand off to the selected project MCP.

The public endpoint is:

https://mcp.spala.ai/mcp

Spala also publishes machine-readable MCP discovery at:

https://spala.ai/.well-known/mcp.json

Do not guess project MCP URLs

Project MCP URLs are resolved after Spala platform authentication from project/access-url data. Do not hardcode patterns like https://api.spala.ai/{project}/mcp.

Public MCP vs project MCP

| MCP surface | Purpose |
| --- | --- |
| https://mcp.spala.ai/mcp | Public discovery, OAuth metadata, agent onboarding, authenticated project lookup, project handoff |
| Project MCP | Backend work for one project: inspect context, make changes, validate, publish, and review |
| OAuth authorization server | Discovered from the MCP OAuth metadata. Do not configure it manually as the MCP server URL. |

Project creation status

project_create is dry-run only in the current public MCP deployment. It previews project creation but does not create a real project.

Start here

Public MCP
Understand the discovery, authentication, project selection, and handoff flow.
/agents/mcp

Codex Setup
Add Spala Public MCP to Codex and start with onboarding/tool-map calls.
/agents/codex

Claude Setup
Add Spala Public MCP to Claude Code over HTTP transport.
/agents/claude

Cursor Setup
Use the same public MCP URL and let Spala resolve project MCP after auth.
/agents/cursor

Gemini CLI Setup
Configure Gemini with Spala Public MCP and the project handoff workflow.
/agents/gemini

VS Code and Copilot Setup
Use Spala Public MCP from VS Code or GitHub Copilot MCP support.
/agents/vscode

Windsurf Setup
Configure Windsurf with Spala Public MCP and safe project handoff.
/agents/windsurf

Cline Setup
Configure Cline with Spala Public MCP and authenticated project selection.
/agents/cline

Public Agent Skills
Use public Spala skill files before authenticated project work.
/agents/skills

Public MCP
/agents/mcp
Discovery, auth, project selection, and project MCP handoff
Public Agent Skills
/agents/skills
Agent-readable skill files for evaluation and safe workflow
Quick Start
/getting-started/quickstart
Build a simple REST API from the dashboard
Publish
/features/publish-export
Validate and publish your backend API