Speedle
MCP server for self-hosted Speedle and Speedle Cloud: authorization checks and policy…
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.9.0
- Listing updated
- today
About Speedle
Speedle is an open-source MCP server. It runs locally on your machine and is started by your AI client.
MCP server for self-hosted Speedle and Speedle Cloud: authorization checks and policy management
Install
Run in a terminal
claude mcp add speedle-mcp --env SPEEDLE_ENDPOINT='<SPEEDLE_ENDPOINT>' --env SPEEDLE_SERVICE_NAME='<SPEEDLE_SERVICE_NAME>' --env SPEEDLE_TOKEN='<SPEEDLE_TOKEN>' --env SPEEDLE_ADS_TOKEN='<SPEEDLE_ADS_TOKEN>' -- npx -y @speedle/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"speedle-mcp": {
"command": "npx",
"args": [
"-y",
"@speedle/mcp"
],
"env": {
"SPEEDLE_ENDPOINT": "<SPEEDLE_ENDPOINT>",
"SPEEDLE_SERVICE_NAME": "<SPEEDLE_SERVICE_NAME>",
"SPEEDLE_TOKEN": "<SPEEDLE_TOKEN>",
"SPEEDLE_ADS_TOKEN": "<SPEEDLE_ADS_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"speedle-mcp": {
"command": "npx",
"args": [
"-y",
"@speedle/mcp"
],
"env": {
"SPEEDLE_ENDPOINT": "<SPEEDLE_ENDPOINT>",
"SPEEDLE_SERVICE_NAME": "<SPEEDLE_SERVICE_NAME>",
"SPEEDLE_TOKEN": "<SPEEDLE_TOKEN>",
"SPEEDLE_ADS_TOKEN": "<SPEEDLE_ADS_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"speedle-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@speedle/mcp"
],
"env": {
"SPEEDLE_ENDPOINT": "<SPEEDLE_ENDPOINT>",
"SPEEDLE_SERVICE_NAME": "<SPEEDLE_SERVICE_NAME>",
"SPEEDLE_TOKEN": "<SPEEDLE_TOKEN>",
"SPEEDLE_ADS_TOKEN": "<SPEEDLE_ADS_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"speedle-mcp": {
"command": "npx",
"args": [
"-y",
"@speedle/mcp"
],
"env": {
"SPEEDLE_ENDPOINT": "<SPEEDLE_ENDPOINT>",
"SPEEDLE_SERVICE_NAME": "<SPEEDLE_SERVICE_NAME>",
"SPEEDLE_TOKEN": "<SPEEDLE_TOKEN>",
"SPEEDLE_ADS_TOKEN": "<SPEEDLE_ADS_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"speedle-mcp": {
"command": "npx",
"args": [
"-y",
"@speedle/mcp"
],
"env": {
"SPEEDLE_ENDPOINT": "<SPEEDLE_ENDPOINT>",
"SPEEDLE_SERVICE_NAME": "<SPEEDLE_SERVICE_NAME>",
"SPEEDLE_TOKEN": "<SPEEDLE_TOKEN>",
"SPEEDLE_ADS_TOKEN": "<SPEEDLE_ADS_TOKEN>"
}
}
}
}Configuration
SPEEDLE_ENDPOINTADS base URL, for example https://cloud.speedle.io or http://127.0.0.1:6734.RequiredSPEEDLE_ADS_ENDPOINTAlias of SPEEDLE_ENDPOINT.SPEEDLE_ADS_URLAlias of SPEEDLE_ENDPOINT.SPEEDLE_SERVICE_NAMEService name sent on every authorization check. Callers cannot override it.RequiredSPEEDLE_SERVICEAlias of SPEEDLE_SERVICE_NAME.SPEEDLE_TOKENAPI key (bearer token) for Speedle Cloud. Required for Speedle Cloud; omit it for a self-hosted ADS without an API key or bearer token. The endpoint must use https://. Never logged or echoed.SPEEDLE_ADS_TOKENAlias of SPEEDLE_TOKEN.SPEEDLE_BACKENDspeedle-cloud or speedle. Defaults to speedle-cloud when SPEEDLE_TOKEN is set, and speedle otherwise.SPEEDLE_ALLOW_INSECURE_HTTPSet to true to allow http:// to a non-loopback host for backend speedle without an API key or bearer token.SPEEDLE_CA_CERTExtra PEM CA certificate for a self-hosted https:// server.SPEEDLE_EXPOSE_DIAGNOSESet to true or 1 to register diagnose. Self-hosted speedle only; refused on speedle-cloud.SPEEDLE_EXPOSE_ALL_GRANTED_ROLESSet to true or 1 to register all_granted_roles.SPEEDLE_EXPOSE_ALL_GRANTED_PERMISSIONSSet to true or 1 to register all_granted_permissions.SPEEDLE_PMS_ENDPOINTPMS or Speedle Cloud base URL, for example http://127.0.0.1:6733 or https://cloud.speedle.io. A trailing /policy-mgmt/v1 is accepted.RequiredSPEEDLE_PMS_BACKENDspeedle-cloud or speedle. Defaults to speedle. SPEEDLE_PMS_TOKEN alone does not select Speedle Cloud.SPEEDLE_PMS_TOKENAPI key (bearer token). Required for speedle-cloud, with scope pms:read or pms:write. The endpoint must use https://. Never logged or echoed.SPEEDLE_PMS_CERTPEM client certificate for mutual TLS. Requires SPEEDLE_PMS_KEY. Cannot be combined with SPEEDLE_PMS_TOKEN.SPEEDLE_PMS_KEYPEM private key for mutual TLS. Requires SPEEDLE_PMS_CERT. Never logged or echoed.SPEEDLE_PMS_ALLOW_INSECURE_HTTPSet to true to allow http:// to a non-loopback host without credentials.SPEEDLE_PMS_CA_CERTExtra PEM CA certificate for a self-hosted https:// server.SPEEDLE_PMS_READ_ONLYSet to true to register only the read tools. Same effect as passing --read-only.
Pricing
Open source
Speedle FAQ
Is Speedle free?
Yes. Speedle is open source, so you can use and self-host it for free.
How do I add Speedle to Claude Code?
Run this command in your terminal: claude mcp add speedle-mcp --env SPEEDLE_ENDPOINT='<SPEEDLE_ENDPOINT>' --env SPEEDLE_SERVICE_NAME='<SPEEDLE_SERVICE_NAME>' --env SPEEDLE_TOKEN='<SPEEDLE_TOKEN>' --env SPEEDLE_ADS_TOKEN='<SPEEDLE_ADS_TOKEN>' -- npx -y @speedle/mcp