Spica MCP Server
OfficialClick on "Deploy 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., "@Spica MCP ServerList all buckets in my Spica database."
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.
@spica/mcp
MCP (Model Context Protocol) server that enables AI agents to interact with Spica servers — manage databases, serverless functions, storage, authentication, auditing and debugging.
Prerequisites
Node.js >= 22
A running Spica server instance
A Spica API key with appropriate permissions
Related MCP server: Spaceship MCP
Installation
npm install -g @spica/mcpOr run directly with npx:
npx @spica/mcpConfiguration
The server requires two environment variables:
Variable | Description |
| URL of your Spica server (e.g. |
| API key for authenticating with the Spica server |
Claude Code
Register the server with the claude CLI:
claude mcp add spica \
--env SPICA_URL=https://my-spica.hq.spicaengine.com/api \
--env SPICA_APIKEY=your-api-key \
-- npx -y @spica/mcpBy default the server is only available in the current project. Add --scope user to make it available in all your projects, or --scope project to write it to a .mcp.json file that can be committed and shared with your team.
Run claude mcp list to verify the connection, or /mcp inside a Claude Code session.
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"spica": {
"command": "npx",
"args": ["-y", "@spica/mcp"],
"env": {
"SPICA_URL": "https://my-spica.hq.spicaengine.com/api",
"SPICA_APIKEY": "your-api-key"
}
}
}
}VS Code
Add to your .vscode/mcp.json:
{
"servers": {
"spica": {
"command": "npx",
"args": ["-y", "@spica/mcp"],
"env": {
"SPICA_URL": "https://my-spica.hq.spicaengine.com/api",
"SPICA_APIKEY": "your-api-key"
}
}
}
}Cursor
Add to your Cursor MCP settings:
{
"mcpServers": {
"spica": {
"command": "npx",
"args": ["-y", "@spica/mcp"],
"env": {
"SPICA_URL": "https://my-spica.hq.spicaengine.com/api",
"SPICA_APIKEY": "your-api-key"
}
}
}
}Available Tools
Authentication
Tool | Description |
| List all API keys |
| Create an API key |
| Update an existing API key |
| List identities with optional filtering and pagination |
| Create an identity |
| Update an existing identity |
| List access policies with optional filtering and pagination |
| Create an access policy |
| Replace an existing access policy |
| List users with optional filtering, sorting and pagination |
Database
Tool | Description |
| List all bucket schemas |
| Create a bucket schema |
| Replace an existing bucket schema |
| Query documents with filtering, pagination, sorting and relation resolution |
| Create or update a document in a bucket |
| Export bucket documents to a local JSON or CSV file |
| Import documents from a local JSON or CSV file into a bucket |
Development
Tool | Description |
| List all serverless functions |
| Get the source code of a function |
| Get installed dependencies for a function |
| Create a serverless function |
| Replace an existing serverless function |
| Replace and compile a function's source code |
| Install npm packages for a function |
| List all environment variables |
| Create an environment variable |
| Update an existing environment variable |
| List all secrets |
| Create a secret |
| Update an existing secret |
Debug
Tool | Description |
| Profile bucket data for debugging |
| Profile user data for debugging |
| Get function execution logs with filtering |
Auditing
Tool | Description |
| Query activity/audit logs with filtering |
Storage
Tool | Description |
| List storage objects with filtering and pagination |
| Create a storage object |
| Replace an existing storage object |
| Rename a storage object |
License
ISC
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for building and testing AI agents with multi-model experimentation and insights.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that enables AI agents to interact with Modal, allowing them to deploy apps and run functions in a serverless cloud environment.73MIT
- AlicenseAqualityDmaintenanceAn MCP server for managing and executing AI agents on the Spaceship AI platform directly from clients like Claude Code and Cursor. It provides comprehensive tools for agent lifecycle management, including creation, execution, and real-time monitoring of run statuses and logs.161MIT
- AlicenseNot gradedqualityDmaintenanceA production-ready MCP server providing AI assistants with intelligent Supabase database access, featuring dynamic schema discovery, complete user management, and file storage operations.1MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for integrating with Bika.ai platform, enabling AI assistants to perform CRUD operations on databases, manage attachments, and utilize automation and webhooks.1MIT