Spaceship MCP
Provides tools to manage AI agents, projects, and executions on the Spaceship AI platform, allowing users to create, update, and run agents, as well as monitor execution status and retrieve logs.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Spaceship MCPrun the 'Support Bot' agent to process a refund for order #1234"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
███████╗██████╗ █████╗ ██████╗███████╗███████╗██╗ ██╗██╗██████╗ █████╗ ██╗
██╔════╝██╔══██╗██╔══██╗██╔════╝██╔════╝██╔════╝██║ ██║██║██╔══██╗ ██╔══██╗██║
███████╗██████╔╝███████║██║ █████╗ ███████╗███████║██║██████╔╝ ███████║██║
╚════██║██╔═══╝ ██╔══██║██║ ██╔══╝ ╚════██║██╔══██║██║██╔═══╝ ██╔══██║██║
███████║██║ ██║ ██║╚██████╗███████╗███████║██║ ██║██║██║ ██║ ██║██║
╚══════╝╚═╝ ╚═╝ ╚═╝ ╚═════╝╚══════╝╚══════╝╚═╝ ╚═╝╚═╝╚═╝ ╚═╝ ╚═╝╚═╝Spaceship AI MCP Server
MCP server for Spaceship AI — build, run, and manage AI agents directly from Claude Code, Cursor, VS Code, and Windsurf.
Quick start
Don't want to manually configure your MCP server?
Run spaceshipai@latest init to set everything up automatically with one command:
npx spaceshipai@latest initThis works with Claude Code, Cursor, VS Code, and Windsurf. It will authenticate via your browser, create a Spaceship API key for you, and configure your editor automatically.
Related MCP server: MCP Plus
Manual installation
If you prefer to configure manually, add the following to your IDE's MCP config file.
Claude Code — run in your terminal:
claude mcp add --scope user --transport stdio spaceship --env SPACESHIP_API_KEY=sk_live_... -- uvx spaceship-mcpOr add to ~/.claude.json:
{
"mcpServers": {
"spaceship": {
"command": "uvx",
"args": ["spaceship-mcp"],
"env": {
"SPACESHIP_API_KEY": "sk_live_..."
}
}
}
}Cursor — add to ~/.cursor/mcp.json:
{
"mcpServers": {
"spaceship": {
"command": "uvx",
"args": ["spaceship-mcp"],
"env": {
"SPACESHIP_API_KEY": "sk_live_..."
}
}
}
}VS Code — add to ~/.vscode/mcp.json:
{
"servers": {
"spaceship": {
"command": "uvx",
"args": ["spaceship-mcp"],
"env": {
"SPACESHIP_API_KEY": "sk_live_..."
}
}
}
}Windsurf — add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"spaceship": {
"command": "uvx",
"args": ["spaceship-mcp"],
"env": {
"SPACESHIP_API_KEY": "sk_live_..."
}
}
}
}Get your API key from spaceshipai.io under Settings → API Keys.
Tools
Projects
Tool | Description |
| List all projects in your organization |
Agents
Tool | Description |
| List agents, optionally filtered by project |
| Get full details of a single agent including its system prompt and tools |
| Create an agent — pass |
| Update name, prompt, or tools; re-scaffold by passing a new |
| Permanently delete an agent and all its logs, memories, and threads |
Running agents
Tool | Description |
| Start an async run; returns |
| Poll status: |
| Fetch the full chronological event log for a completed run |
| List recent runs for an agent with status and duration |
| Quick sync test — runs an agent and waits up to 15s for the result |
Orchestrations
Tool | Description |
| List orchestrations, optionally filtered by project |
| Get full details of an orchestration including its members and tools |
| Start an async orchestration run; returns |
| Quick sync test — runs an orchestration and waits up to 15s for the result |
Tools
Tool | Description |
| List built-in and custom tools available to attach to agents |
Example prompts
Once installed, you can talk to your agents naturally in any supported IDE:
List my projects, then show me all agents in the "production" project.Create an agent called "Support Bot" in project 12 that handles customer refund requests.Run the "Data Processor" agent with the prompt "Summarize last week's sales data".Check the status of execution abc-123 for agent xyz-456, then show me the logs.Test the "Email Classifier" agent with "Is this email spam: win a free iPhone now!"List my orchestrations in the "production" project, then run the "Data Pipeline" orchestration.Test the "Research Team" orchestration with input {"topic": "AI safety"} and show me the result.Configuration
Variable | Required | Default | Description |
| Yes | — | Your API key ( |
| No |
| Override for local dev or staging |
Development
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest tests/ -vLicense
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceAn MCP server that enables AI agents to interact with the SpaceTraders API, managing agents, fleets, contracts, and trading operations in the SpaceTraders universe.Last updatedMIT
- FlicenseAqualityDmaintenanceA TypeScript MCP server for launching, tracking, and managing external coding-agent runs across local and remote backends like Codex and Claude Code. It allows top-level agents to orchestrate subagents through tools for spawning tasks, polling events, and handling interactive sessions.Last updated72
- Alicense-qualityCmaintenanceA portable MCP server that provides a shared persistent working state for AI coding agents, managing tasks, plans, notepads, memory, and project rules across different tools like Claude Code, OpenCode, and Cursor.Last updated19MIT
Related MCP Connectors
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Real-time chat hub for AI agents — Claude Code, Cursor, Cline, Codex over MCP or REST.
Real-time chat hub for AI agents — Claude Code, Cursor, Cline, Codex over MCP or REST.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Spaceship-AI/spaceship-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server