Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion third_party/statsig/.cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "statsig",
"displayName": "Statsig",
"version": "1.0.0",
"version": "2.0.0",
"minClientVersions": {
"cursor": "3.13.0"
},
Expand Down
6 changes: 6 additions & 0 deletions third_party/statsig/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@

All notable changes to this plugin will be documented here.

## 2.0.0

- Switch the hosted MCP endpoint to `https://api.statsig.com/v3/mcp`.
- MCP v3 changes tool names and input schemas; use the advertised tool catalog and `discover_tools` for capabilities that are not visible.
- Add upgrade guidance for reconnecting, refreshing the tool catalog, and migrating manually configured connections.

## 1.0.0 — initial release

- Added the `statsig` MCP server pointing at Statsig's hosted Streamable HTTP endpoint (`https://api.statsig.com/v1/mcp`).
Expand Down
14 changes: 10 additions & 4 deletions third_party/statsig/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,14 +21,20 @@ Or run `/add-plugin statsig` in chat.
"mcpServers": {
"statsig": {
"type": "http",
"url": "https://api.statsig.com/v1/mcp"
"url": "https://api.statsig.com/v3/mcp"
}
}
}
```

Auth is OAuth against Statsig. Cursor prompts for Statsig user login when the plugin connects — there is no API key or client ID to configure.

## Upgrading from 1.x

Version 2.0.0 connects to MCP v3, which changes the tool names and input schemas. After updating the plugin, reconnect the Statsig server and start a new chat so the agent loads the current tool catalog. Complete the Statsig sign-in prompt if Cursor requests authorization again.

Existing manually configured MCP connections are not changed by this plugin update. If you also configured Statsig manually, update that connection separately and avoid enabling duplicate Statsig connections. Instructions or automations that hardcode legacy tool names must be updated to the tools advertised by v3.

## Before you connect

You need a Statsig account with access to a project. Statsig's MCP OAuth issues a **Personal Console API Key** scoped to your role, so your Statsig org owner must have enabled Personal Console API Key creation for your role under organization settings. If sign-in fails, ask your org owner to enable it.
Expand All @@ -42,12 +48,12 @@ You need a Statsig account with access to a project. Statsig's MCP OAuth issues
| Dynamic configs | List configs, get targeting rules and return values, and create or replace configs |
| Metrics | List metrics and metric sources and read metric definitions |

The hosted runtime is the source of truth for tool names and schemas.
The hosted runtime is the source of truth for tool names and schemas. MCP v3 consolidates related actions into typed tools. Use the tools advertised by the connected server; if a capability is not visible, use `discover_tools` to find the operation and its current input schema.

## Notes

- Tool calls run as the Statsig user who authorizes the connection and cannot exceed that user's role permissions. Read-only roles can use every read tool; write tools require a role with write access.
- `Update_*_Entirely` tools replace the whole entity — any field left out is removed. Read the entity first and confirm before writing.
- For operations that replace an entity, read the current entity first and preserve fields that should remain unchanged. Confirm the intended change before writing and follow any review or acknowledgement requirements returned by the server.
- Statsig also documents an API-key setup that runs `npx mcp-remote` locally with a `statsig-api-key` header. This plugin intentionally packages only the OAuth Streamable HTTP endpoint and does not wrap a local stdio server.
- Revoke access at any time by deleting the Personal Console API Key from your Statsig project's API keys page.

Expand All @@ -56,7 +62,7 @@ The hosted runtime is the source of truth for tool names and schemas.
- Statsig MCP in Cursor: https://docs.statsig.com/integrations/mcp/cursor
- Statsig MCP overview and tool list: https://docs.statsig.com/integrations/mcp/overview
- Personal Console API Keys: https://docs.statsig.com/access-management/api-keys
- Server URL: https://api.statsig.com/v1/mcp
- Server URL: https://api.statsig.com/v3/mcp

Logo is Statsig's official mark, from the `statsig-io` GitHub organization.

Expand Down
2 changes: 1 addition & 1 deletion third_party/statsig/mcp.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"mcpServers": {
"statsig": {
"type": "http",
"url": "https://api.statsig.com/v1/mcp"
"url": "https://api.statsig.com/v3/mcp"
}
}
}