Search / io.github.ahmad-codex/workstream-mcp
Workstream
L0· runs locallyShared task ledger for AI agents and humans: atomic claims, state machine, GitHub and Slack sync
v0.2.0 · active · repository · website · descriptor JSON · versions
Search / io.github.ahmad-codex/workstream-mcp
L0· runs locallyShared task ledger for AI agents and humans: atomic claims, state machine, GitHub and Slack sync
v0.2.0 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"workstream-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"WORKSTREAM_DB_CONNECTION",
"-e",
"WORKSTREAM_ADMIN_TOKEN",
"-e",
"WORKSTREAM_PUBLIC_BASE_URL",
"-e",
"WORKSTREAM_USER_TOKEN",
"ghcr.io/ahmad-codex/workstream-mcp:0.2.0"
],
"env": {
"WORKSTREAM_DB_CONNECTION": "${WORKSTREAM_DB_CONNECTION}",
"WORKSTREAM_ADMIN_TOKEN": "${WORKSTREAM_ADMIN_TOKEN}",
"WORKSTREAM_PUBLIC_BASE_URL": "http://localhost:8080",
"WORKSTREAM_USER_TOKEN": "${WORKSTREAM_USER_TOKEN}"
}
}
}
}claude mcp add workstream-mcp -e "WORKSTREAM_DB_CONNECTION=${WORKSTREAM_DB_CONNECTION}" -e "WORKSTREAM_ADMIN_TOKEN=${WORKSTREAM_ADMIN_TOKEN}" -e "WORKSTREAM_PUBLIC_BASE_URL=http://localhost:8080" -e "WORKSTREAM_USER_TOKEN=${WORKSTREAM_USER_TOKEN}" -- docker run -i --rm -e WORKSTREAM_DB_CONNECTION -e WORKSTREAM_ADMIN_TOKEN -e WORKSTREAM_PUBLIC_BASE_URL -e WORKSTREAM_USER_TOKEN ghcr.io/ahmad-codex/workstream-mcp:0.2.0[mcp_servers.workstream-mcp]
command = "docker"
args = ["run", "-i", "--rm", "-e", "WORKSTREAM_DB_CONNECTION", "-e", "WORKSTREAM_ADMIN_TOKEN", "-e", "WORKSTREAM_PUBLIC_BASE_URL", "-e", "WORKSTREAM_USER_TOKEN", "ghcr.io/ahmad-codex/workstream-mcp:0.2.0"]
env = { "WORKSTREAM_DB_CONNECTION" = "${WORKSTREAM_DB_CONNECTION}", "WORKSTREAM_ADMIN_TOKEN" = "${WORKSTREAM_ADMIN_TOKEN}", "WORKSTREAM_PUBLIC_BASE_URL" = "http://localhost:8080", "WORKSTREAM_USER_TOKEN" = "${WORKSTREAM_USER_TOKEN}" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"workstream-mcp": {
"type": "local",
"command": [
"docker",
"run",
"-i",
"--rm",
"-e",
"WORKSTREAM_DB_CONNECTION",
"-e",
"WORKSTREAM_ADMIN_TOKEN",
"-e",
"WORKSTREAM_PUBLIC_BASE_URL",
"-e",
"WORKSTREAM_USER_TOKEN",
"ghcr.io/ahmad-codex/workstream-mcp:0.2.0"
],
"enabled": true,
"environment": {
"WORKSTREAM_DB_CONNECTION": "{env:WORKSTREAM_DB_CONNECTION}",
"WORKSTREAM_ADMIN_TOKEN": "{env:WORKSTREAM_ADMIN_TOKEN}",
"WORKSTREAM_PUBLIC_BASE_URL": "http://localhost:8080",
"WORKSTREAM_USER_TOKEN": "{env:WORKSTREAM_USER_TOKEN}"
}
}
}
}{
"mcpServers": {
"workstream-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"WORKSTREAM_DB_CONNECTION",
"-e",
"WORKSTREAM_ADMIN_TOKEN",
"-e",
"WORKSTREAM_PUBLIC_BASE_URL",
"-e",
"WORKSTREAM_USER_TOKEN",
"ghcr.io/ahmad-codex/workstream-mcp:0.2.0"
],
"env": {
"WORKSTREAM_DB_CONNECTION": "${WORKSTREAM_DB_CONNECTION}",
"WORKSTREAM_ADMIN_TOKEN": "${WORKSTREAM_ADMIN_TOKEN}",
"WORKSTREAM_PUBLIC_BASE_URL": "http://localhost:8080",
"WORKSTREAM_USER_TOKEN": "${WORKSTREAM_USER_TOKEN}"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=workstream-mcp&config=eyJjb21tYW5kIjoiZG9ja2VyIiwiYXJncyI6WyJydW4iLCItaSIsIi0tcm0iLCItZSIsIldPUktTVFJFQU1fREJfQ09OTkVDVElPTiIsIi1lIiwiV09SS1NUUkVBTV9BRE1JTl9UT0tFTiIsIi1lIiwiV09SS1NUUkVBTV9QVUJMSUNfQkFTRV9VUkwiLCItZSIsIldPUktTVFJFQU1fVVNFUl9UT0tFTiIsImdoY3IuaW8vYWhtYWQtY29kZXgvd29ya3N0cmVhbS1tY3A6MC4yLjAiXSwiZW52Ijp7IldPUktTVFJFQU1fREJfQ09OTkVDVElPTiI6IiR7V09SS1NUUkVBTV9EQl9DT05ORUNUSU9OfSIsIldPUktTVFJFQU1fQURNSU5fVE9LRU4iOiIke1dPUktTVFJFQU1fQURNSU5fVE9LRU59IiwiV09SS1NUUkVBTV9QVUJMSUNfQkFTRV9VUkwiOiJodHRwOi8vbG9jYWxob3N0OjgwODAiLCJXT1JLU1RSRUFNX1VTRVJfVE9LRU4iOiIke1dPUktTVFJFQU1fVVNFUl9UT0tFTn0ifX0%3D"
}{
"servers": {
"workstream-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"WORKSTREAM_DB_CONNECTION",
"-e",
"WORKSTREAM_ADMIN_TOKEN",
"-e",
"WORKSTREAM_PUBLIC_BASE_URL",
"-e",
"WORKSTREAM_USER_TOKEN",
"ghcr.io/ahmad-codex/workstream-mcp:0.2.0"
],
"env": {
"WORKSTREAM_DB_CONNECTION": "${WORKSTREAM_DB_CONNECTION}",
"WORKSTREAM_ADMIN_TOKEN": "${WORKSTREAM_ADMIN_TOKEN}",
"WORKSTREAM_PUBLIC_BASE_URL": "http://localhost:8080",
"WORKSTREAM_USER_TOKEN": "${WORKSTREAM_USER_TOKEN}"
}
}
}
}{
"mcpServers": {
"workstream-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"WORKSTREAM_DB_CONNECTION",
"-e",
"WORKSTREAM_ADMIN_TOKEN",
"-e",
"WORKSTREAM_PUBLIC_BASE_URL",
"-e",
"WORKSTREAM_USER_TOKEN",
"ghcr.io/ahmad-codex/workstream-mcp:0.2.0"
],
"env": {
"WORKSTREAM_DB_CONNECTION": "${WORKSTREAM_DB_CONNECTION}",
"WORKSTREAM_ADMIN_TOKEN": "${WORKSTREAM_ADMIN_TOKEN}",
"WORKSTREAM_PUBLIC_BASE_URL": "http://localhost:8080",
"WORKSTREAM_USER_TOKEN": "${WORKSTREAM_USER_TOKEN}"
}
}
}
}extensions:
"workstream-mcp":
enabled: true
name: "workstream-mcp"
type: stdio
cmd: "docker"
args:
- "run"
- "-i"
- "--rm"
- "-e"
- "WORKSTREAM_DB_CONNECTION"
- "-e"
- "WORKSTREAM_ADMIN_TOKEN"
- "-e"
- "WORKSTREAM_PUBLIC_BASE_URL"
- "-e"
- "WORKSTREAM_USER_TOKEN"
- "ghcr.io/ahmad-codex/workstream-mcp:0.2.0"
envs:
"WORKSTREAM_DB_CONNECTION": "${WORKSTREAM_DB_CONNECTION}"
"WORKSTREAM_ADMIN_TOKEN": "${WORKSTREAM_ADMIN_TOKEN}"
"WORKSTREAM_PUBLIC_BASE_URL": "http://localhost:8080"
"WORKSTREAM_USER_TOKEN": "${WORKSTREAM_USER_TOKEN}"
timeout: 300
Placeholders to fill from your own secret store: ${WORKSTREAM_DB_CONNECTION}, ${WORKSTREAM_ADMIN_TOKEN}, ${WORKSTREAM_USER_TOKEN}. The registry never accepts secret values.
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)stability.changes, stability.rug_pulltool list unknowndeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website ~liveness-unmeasured +updated-5d-ago -unpinned-packages(1)
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
ghcr.io/ahmad-codex/workstream-mcp:0.2.0 | oci | unpinned | – | WORKSTREAM_DB_CONNECTION, WORKSTREAM_ADMIN_TOKEN, WORKSTREAM_USER_TOKEN |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
{
"name": "io.github.ahmad-codex/workstream-mcp",
"title": "Workstream",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "0.2.0",
"packages": [
{
"transport": {
"url": "http://localhost:8080/{WORKSTREAM_USER_TOKEN}/mcp",
"type": "streamable-http"
},
"identifier": "ghcr.io/ahmad-codex/workstream-mcp:0.2.0",
"registryType": "oci",
"environmentVariables": [
{
"name": "WORKSTREAM_DB_CONNECTION",
"isSecret": true,
"isRequired": true,
"description": "Npgsql connection string for the PostgreSQL 16 database"
},
{
"name": "WORKSTREAM_ADMIN_TOKEN",
"isSecret": true,
"isRequired": true,
"description": "Bearer token for the /admin API, used to create users"
},
{
"name": "WORKSTREAM_PUBLIC_BASE_URL",
"default": "http://localhost:8080",
"description": "Public base URL used when returning user MCP URLs"
},
{
"name": "WORKSTREAM_USER_TOKEN",
"isSecret": true,
"isRequired": true,
"description": "Your user token from POST /admin/users. Only used to build the client URL; the server does not read it."
}
]
}
],
"repository": {
"url": "https://github.com/ahmad-codex/workstream-mcp",
"source": "github"
},
"websiteUrl": "https://github.com/ahmad-codex/workstream-mcp",
"description": "Shared task ledger for AI agents and humans: atomic claims, state machine, GitHub and Slack sync"
}