pocketid-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
pocketid-mcp
MCP (Model Context Protocol) server for managing Pocket ID instances. Provides 57 tools for user management, OIDC client configuration, group management, audit logs, and more — all accessible through any MCP-compatible client.
Requirements
Bun v1.0+
A running Pocket ID instance with an API key
Related MCP server: AccelMCP
Installation
From Release Binary
Download the latest binary for your platform from the Releases page.
From Source
git clone https://github.com/nikkomiu/pocketid-mcp.git
cd pocketid-mcp
bun installConfiguration
Environment Variables
Variable | Required | Default | Description |
| Yes | — | Base URL of your Pocket ID instance (e.g. |
| Yes | — | API key for authentication (create via Pocket ID admin dashboard under Settings > API Keys) |
| No |
| Log level ( |
| No |
| Log file name or absolute path |
| No | (auto-resolved) | Directory for log file |
| No |
| Also write logs to stderr |
| No |
| Truncate old log entries on startup |
| No |
| Max age in hours for log truncation |
Claude Code
Add to your Claude Code MCP settings (~/.claude/settings.json or project .mcp.json):
{
"mcpServers": {
"pocketid": {
"command": "/path/to/pocketid-mcp",
"env": {
"POCKETID_URL": "https://auth.example.com",
"POCKETID_API_KEY": "your-api-key"
}
}
}
}Or when running from source:
{
"mcpServers": {
"pocketid": {
"command": "bun",
"args": ["run", "/path/to/pocketid-mcp/src/index.ts"],
"env": {
"POCKETID_URL": "https://auth.example.com",
"POCKETID_API_KEY": "your-api-key"
}
}
}
}Usage
Once configured, the following tools are available through your MCP client:
Users
Tool | Description |
| List users with pagination, search, and sorting |
| Get a user by ID |
| Create a new user |
| Update an existing user |
| Delete a user |
| List groups for a specific user |
| Update group memberships for a user |
| Create a one-time access token for a user |
| Send a one-time access email to a user |
User Groups
Tool | Description |
| List user groups with pagination and search |
| Get a user group by ID |
| Create a new user group |
| Update a user group |
| Delete a user group |
| Add or remove users from a group |
| Configure which OIDC clients can access this group |
OIDC Clients
Tool | Description |
| List OIDC clients with pagination and search |
| Get an OIDC client by ID |
| Create a new OIDC client |
| Update an OIDC client |
| Delete an OIDC client |
| Generate a new client secret |
| Configure allowed user groups for a client |
| Preview token claims for a specific user |
| List authorized clients for a user |
| Revoke a client authorization |
API Keys
Tool | Description |
| List API keys |
| Create a new API key |
| Renew an API key's expiration |
| Delete an API key |
Audit Logs
Tool | Description |
| List current user's audit logs |
| List all audit logs (admin only) |
| Get client names for audit log filtering |
| Get usernames for audit log filtering |
Custom Claims
Tool | Description |
| Get suggested custom claim names |
| Set custom claims for a user |
| Set custom claims for a user group |
App Configuration
Tool | Description |
| Get public application configuration |
| Get all configuration (admin only) |
| Update application configuration |
| Send a test email |
| Trigger LDAP synchronization |
Signup Tokens
Tool | Description |
| List signup tokens |
| Create a signup token |
| Delete a signup token |
SCIM Provisioning
Tool | Description |
| Create a SCIM service provider |
| Update a SCIM service provider |
| Delete a SCIM service provider |
| Trigger a manual SCIM sync |
OIDC Discovery
Tool | Description |
| Get OpenID Connect discovery document |
| Get JSON Web Key Set |
App Images
Tool | Description |
| Upload or update the application logo |
| Upload or update the favicon |
| Upload or update the background image |
| Remove the default profile picture |
Utility
Tool | Description |
| Check Pocket ID instance health |
| Get the latest available Pocket ID version |
Audit Trail
All mutating operations (POST, PUT, DELETE) are automatically logged at info level with structured fields:
{
"level": 30,
"time": "2026-02-13T10:30:00.000Z",
"tool": "user_create",
"httpMethod": "POST",
"path": "/api/users",
"resourceId": null,
"success": true,
"msg": "audit: user_create POST /api/users OK"
}Request/response bodies, API keys, and PII are never logged.
Development
Run from Source
bun run startBuild Standalone Binary
bun run buildProduces dist/pocketid-mcp.
Type Check
bun run type-checkLint
bun run lintFormat
bun run formatLicense
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
One OAuth connector for your team's remote MCP servers, with Tool Packs, guardrails and logs.
FusionAuth Documentation MCP server
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA production-ready MCP server for Identity and Access Management with Okta integration, providing user and group management, audit logging, and permission guardrails.-
- FlicenseNot gradedqualityCmaintenanceAn MCP server with HTTP/stdio support, a web admin panel for managing services, capabilities, and user permissions with Bearer token authentication, enabling relay and access control for MCP tools.-
- AlicenseNot gradedqualityBmaintenanceMCP server for managing Ory Kratos identities, sessions, and authentication flows, enabling AI assistants to perform identity management tasks via natural language.13 npm1MIT
- FlicenseNot gradedqualityDmaintenanceMulti-tenant MCP server with OAuth 2.1 authorization, enabling tenant-scoped tool access and audit logging.-