MCPocket
by romanbwrk
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DATA_DIR | No | Data directory for the JSON driver (and default location for the SQLite file). | ./data |
| MONGODB_DB | No | MongoDB database name. | mcpocket |
| MONGODB_URI | No | MongoDB connection URI when `STORAGE_DRIVER=mongo`. | |
| SQLITE_FILE | No | SQLite database file when `STORAGE_DRIVER=sqlite`. Defaults to `DATA_DIR/mcpocket.db`. | |
| MCPOCKET_PORT | No | Port for the dashboard, REST and MCP endpoints. | 3000 |
| STORAGE_DRIVER | No | Storage driver: `json` (default), `sqlite`, or `mongo`. | json |
| MCPOCKET_API_KEYS | No | `keyId:secret` pairs (comma/newline separated) for REST/MCP clients. Alternatively, create managed keys on the dashboard's Access page. | |
| MCPOCKET_WORKSPACE | No | Workspace (tenant) slug this instance serves. Defaults to `MCPOCKET_SSO_WORKSPACE`. | |
| MCPOCKET_OAUTH_CLAIM | No | Name of the OAuth grant claim. | mcpocket |
| MCPOCKET_OAUTH_ISSUER | No | Exact `iss` of accepted OAuth access tokens; set to enable OAuth for MCP clients (e.g. ChatGPT connectors). | |
| MCPOCKET_API_KEY_ROLES | No | `keyId:role` pairs for env API keys, e.g. `ci:readonly,bots:agent`. | |
| MCPOCKET_COOKIE_SECURE | No | Set to `false` only when serving production over plain HTTP. Default is `true` in production. | true |
| MCPOCKET_LEASE_SECONDS | No | Default lease duration for claim / heartbeat. | 300 |
| MCPOCKET_RETRY_BACKOFF | No | Retry backoff strategy: `exponential` or `fixed`. | exponential |
| MCPOCKET_ADMIN_PASSWORD | Yes | Admin password. Required; without it the login page shows setup instructions and nobody can sign in. Compose refuses to start while it is empty. | |
| MCPOCKET_ADMIN_USERNAME | No | Admin login name. | admin |
| MCPOCKET_OAUTH_AUDIENCE | No | Required `aud` claim in OAuth tokens (not checked when unset; Supabase: `authenticated`). | |
| MCPOCKET_OAUTH_JWKS_URL | No | Signing keys URL; defaults to `<issuer>/.well-known/jwks.json`. | |
| MCPOCKET_SESSION_SECRET | No | Key for signing session cookies (`openssl rand -base64 32`). Set it explicitly in production. Defaults to a value derived from the admin password. | |
| MCPOCKET_MULTI_WORKSPACE | No | Set to `true` (requires `mongo`) to serve every workspace from one instance, with each request acting in the workspace of its credential. | false |
| MCPOCKET_OAUTH_WORKSPACE | No | Workspace slug the OAuth grant must name; unset = any. Defaults to `MCPOCKET_SSO_WORKSPACE`. | |
| MCPOCKET_SWEEPER_ENABLED | No | Set to `false` to disable the background lease sweeper (claims still recover expired leases). | true |
| MCPOCKET_SESSION_TTL_HOURS | No | Session lifetime in hours. | 12 |
| MCPOCKET_RETRY_MAX_ATTEMPTS | No | Total attempts (claims) per item; `1` = never retry. | 3 |
| MCPOCKET_RETRY_DELAY_SECONDS | No | Base retry delay in seconds. | 30 |
| MCPOCKET_SEED_ON_FIRST_START | No | Set to `true` to seed an empty volume/workspace from `mock/seed.json` on first start. Existing data is never touched. Set to `false` to start empty. | true |
| MCPOCKET_API_KEY_DEFAULT_ROLE | No | Role of env API keys not listed in `MCPOCKET_API_KEY_ROLES`. | admin |
| MCPOCKET_RATE_LIMIT_PER_MINUTE | No | Requests per API key per minute (managed keys may override; `0` = unlimited). | 600 |
| MCPOCKET_RETRY_MAX_DELAY_SECONDS | No | Cap for the exponential retry delay in seconds. | 3600 |
| MCPOCKET_SWEEPER_INTERVAL_SECONDS | No | Seconds between sweeps (1..3600). | 15 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues