Stape MCP Server
stape-io/stape-mcp-server · 17 stars · Apache-2.0
MCP server Interact with the Seape API using AI assistants like Claude, or in AI-powered IDEs like Cursor.
Install
The repo has no one-line install. Follow its README.
Files
Stape MCP Server
This project implements an MCP (Model Context Protocol) server for the Stape platform.
Table of Contents
- API Documentation
- Prerequisites
- Installation
- EU Endpoint Support
- Available tools
- Troubleshooting
- Useful resources
- Open Source
API Documentation
The server wraps the Stape REST API. Full endpoint reference:
Prerequisites
- Node.js (v18 or higher)
Installation
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.
Claude Desktop
⬇️ Click to expand ⬇️
Add this to your claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"stape-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.stape.ai/mcp",
"--header",
"Authorization: ${your_stape_api_key}"
]
}
}
}
Claude Code
⬇️ Click to expand ⬇️
claude mcp add --transport http stape-mcp-server https://mcp.stape.ai/mcp \
--header "Authorization: ${your_stape_api_key}"
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
⬇️ Click to expand ⬇️
VS Code's MCP client supports HTTP servers natively, no mcp-remote needed. Add this to .vscode/mcp.json:
{
"servers": {
"stape-mcp-server": {
"type": "http",
"url": "https://mcp.stape.ai/mcp",
"headers": {
"Authorization": "${your_stape_api_key}"
}
}
}
}
Copilot CLI
⬇️ Click to expand ⬇️
copilot mcp add --transport http stape-mcp-server https://mcp.stape.ai/mcp \
--header "Authorization: ${your_stape_api_key}"
This writes the server entry into ~/.copilot/mcp-config.json. See GitHub's docs for more on the copilot mcp add subcommand.
GitHub Copilot
⬇️ Click to expand ⬇️
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
⬇️ Click to expand ⬇️
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):
{
"mcpServers": {
"stape-mcp-server": {
"url": "https://mcp.stape.ai/mcp",
"headers": {
"Authorization": "${your_stape_api_key}"
}
}
}
}
Antigravity
⬇️ Click to expand ⬇️
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:
{
"mcpServers": {
"stape-mcp-server": {
"serverUrl": "https://mcp.stape.ai/mcp",
"headers": {
"Authorization": "${your_stape_api_key}"
}
}
}
}
ChatGPT
⬇️ Click to expand ⬇️
- In ChatGPT, enable Developer mode: Settings → Apps & Connectors → Advanced settings → Developer mode.
- Go to Settings → Connectors → Create, and set the server URL to
https://mcp.stape.ai/mcp. - Authenticate with your Stape API key. ChatGPT's connector UI is OAuth-first and support for a raw
Authorizationheader varies by rollout — if there's no field for it, use one of the other clients above instead.
Other MCP clients
⬇️ Click to expand ⬇️
Any other MCP-compatible client that expects a stdio-style command/args config can use the same mcp-remote block:
{
"mcpServers": {
"stape-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.stape.ai/mcp",
"--header",
"Authorization: ${your_stape_api_key}"
]
}
}
}
EU Endpoint Support
If you are using Stape EU environment, you need to provide an additional header X-Stape-Region: EU.
{
"mcpServers": {
"stape-mcp-server-eu": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.stape.ai/mcp",
"--header",
"Authorization: ${your_stape_api_key}",
"--header",
"X-Stape-Region: EU"
]
}
}
}
Available tools
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 |
Troubleshooting
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:
- Use shorter server names in your MCP configuration (e.g.,
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:
rm -rf ~/.mcp-auth
Useful resources
Facts
- Kind
- MCP server
- Group
- Uncategorized
- Stars
- 17
- License
- Apache-2.0
- Last push
- 2026-10-06
- Forks
- 9
- Homepage
- stape.io
- Topics
- gtm, gtm-server-side, mcp, mcp-server, stape
- 1REAio.github.morluto/reaReverse engineer anything from your terminal or agent with one CLI and MCP server.125.3k
- 2com.browser-use/browser-usecom.browser-use/browser-useControl a real Chrome browser to complete any task: fill forms, extract data, book flights.117.7k
- 3World Monitorapp.worldmonitor/mcpLive markets, conflicts, country risk, chokepoints, energy, and China decision signals. 93 tools.88.3k
- 4Scrapling MCP Serverd4vinci/scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scraplingdev86.9k
- 5Everythingmodelcontextprotocol/serversThis MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test server for builders of MCP clients. It implements prompts, tools, resources, sampling, and more to showcase MCP capabilities.85.8k
- 6Fetchmodelcontextprotocol/serversA Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption.85.8k