The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Stape MCP Server listing page.
This project implements an MCP (Model Context Protocol) server for the Stape platform.
The server wraps the Stape REST API. Full endpoint reference:
The Stape MCP Server is a remote, HTTP-based MCP endpoint at https://mcp.stape.ai/mcp. Most clients reach it through mcp-remote, a small bridge that lets stdio-only clients talk to a remote HTTP MCP server; a few clients (VS Code, Cursor, Antigravity) speak HTTP directly.
Get a Stape API key from your Stape account and use it instead of ${your_stape_api_key} below (learn how). Restart the client after changing its config.
Using the Stape EU environment? Every config below needs one extra header — see EU Endpoint Support.
Add this to your claude_desktop_config.json (Settings → Developer → Edit Config):
This writes the same server entry into .mcp.json / your Claude Code MCP config. Run /mcp inside Claude Code to confirm it connected.
VS Code's MCP client supports HTTP servers natively, no mcp-remote needed. Add this to .vscode/mcp.json:
This writes the server entry into ~/.copilot/mcp-config.json. See GitHub's docs for more on the copilot mcp add subcommand.
GitHub Copilot Chat in VS Code uses VS Code's own MCP client, so it reads the same .vscode/mcp.json file — see VS Code above. No separate configuration is needed.
Cursor speaks HTTP directly too, no mcp-remote needed. Add this to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global — Settings → MCP → Add new global MCP server):
Antigravity also speaks HTTP directly, using serverUrl instead of url. Add this to ~/.gemini/config/mcp_config.json (global) or .agents/mcp_config.json (workspace-local) — accessible from the editor's agent panel via … → MCP Servers → Manage MCP Servers → View raw config:
https://mcp.stape.ai/mcp.Authorization header varies by rollout — if there's no field for it, use one of the other clients above instead.Any other MCP-compatible client that expects a stdio-style command/args config can use the same mcp-remote block:
If you are using Stape EU environment, you need to provide an additional header X-Stape-Region: EU.
Each tool takes an action parameter selecting the operation (list, get, create, update, delete, …). Destructive actions additionally require confirm: true.
| Area | Tools |
|---|---|
| Containers | stape_container_crud, stape_container_lifecycle, stape_container_domains, stape_container_schedules, stape_container_power_ups, stape_container_proxy_files, stape_container_connections, stape_container_resources |
| Monitoring & logs | stape_container_monitoring, stape_container_monitoring_logs, stape_container_logs, stape_container_analytics, stape_container_statistics |
| Billing | stape_billing, stape_consolidated_invoicing, stape_invoices, stape_payment_links, stape_subscriptions, stape_container_subscription, stape_container_paddle |
| Account & access | stape_account, stape_users, stape_user_api_keys, stape_company, stape_share_access |
| Partners | stape_partner, stape_partner_payouts |
| Stape Score | stape_score_report — scan a website's tracking setup with Stape Score (create a scan, fetch results) |
| Reference data | stape_container_resource, stape_domains_resource, stape_gateway_resource, stape_logs_resource, stape_monitoring_resource, stape_billing_resource, stape_partner_resource, stape_products, stape_calculator |
MCP Server Name Length Limit
Some MCP clients (like Cursor AI) have a 60-character limit for the combined MCP server name + tool name length. If you use a longer server name in your configuration (e.g., stape-mcp-server-your-additional-long-name), some tools may be filtered out.
To avoid this issue:
stape-mcp-server)Clearing MCP Cache
mcp-remote stores all the credential information inside ~/.mcp-auth (or wherever your MCP_REMOTE_CONFIG_DIR points to). If you're having persistent issues, clear it and restart your MCP client:
The Stape MCP Server is developed and maintained by Stape Team under the Apache 2.0 license.