Install
The installation steps are in the documentation below. Documentation
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
S2 StreamStore MCP Server
An MCP server for S2 StreamStore built with Concierge progressive tool disclosure.
Instead of exposing all S2 API tools at once, the server guides AI agents through a natural workflow:
account → basin → streamAt each stage, only the relevant tools are visible.
Stages
| Stage | Tools | Description |
|---|---|---|
| account | list_basins, create_basin, select_basin, list_access_tokens, issue_access_token, revoke_access_token, account_metrics | Manage basins and access tokens |
| basin | get_basin_config, reconfigure_basin, delete_basin, list_streams, create_stream, select_stream, basin_metrics, go_back_to_account | Manage streams within a basin |
| stream | get_stream_config, reconfigure_stream, delete_stream, append_records, read_records, check_tail, stream_metrics, go_back_to_basin | Read/write records and manage stream config |
Setup
pip install -e .Configuration
Set your S2 access token as an environment variable:
export S2_ACCESS_TOKEN="your-token-here"Run
stdio (for Cursor, Claude Desktop, etc.):
python main.pyMCP Client Configuration
Add to your MCP client config (e.g. ~/.cursor/mcp.json):
{
"mcpServers": {
"s2": {
"command": "python",
"args": ["/path/to/mcp/main.py"],
"env": {
"S2_ACCESS_TOKEN": "your-token-here"
}
}
}
}Frequently asked questions
What is MCP?
Interact with the S2 serverless stream platform.
How do I install MCP?
Follow the installation steps in its documentation, shown on this page and in its repository.
Is MCP open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains MCP?
It is published by s2-streamstore. AI.tn lists it but does not maintain or endorse it.
From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.