π
Permit MCP Server
MCP Server for Permit.io read-only operations
0 installs
Trust: 37 β Low
Security
Ask AI about Permit MCP Server
Powered by Claude Β· Grounded in docs
I know everything about Permit MCP Server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
Permit MCP Server
Read-only MCP Server for querying Permit.io configuration.
Quick Start with npx
Run directly without installation:
PERMIT_API_KEY=your_key npx permit-mcp-server
Requirements
- Node.js 22+
- pnpm (for development)
- Docker (optional)
Installation
Global Installation
npm install -g permit-mcp-server
Local Installation
cd permit-mcp
pnpm install
pnpm build
Configuration
Create a .env file based on .env.example:
PERMIT_API_KEY=permit_key_xxxxx
PERMIT_PROJECT_ID=default
PERMIT_ENV_ID=dev
Environment Variables
| Variable | Required | Description |
|---|---|---|
PERMIT_API_KEY | Yes | Permit.io API Key |
PERMIT_PROJECT_ID | No | Project ID (default: "default") |
PERMIT_ENV_ID | No | Default environment |
Docker
Start with Docker Compose
cd permit-mcp && docker compose -f docker-compose.local.yml up -d --build
Stop
docker compose -f docker-compose.local.yml down
View logs
docker logs -f permit-mcp
Available Tools
Environments
- list-environments: List all environments in the project
- get-environment: Get details of a specific environment
Roles
- list-roles: List all roles in an environment
- get-role: Get a role with its permissions
Resources
- list-resources: List all defined resources
- get-resource: Get a resource with its actions and attributes
Users
- list-users: List users with optional filters (pagination, search)
- get-user: Get user information
- get-user-permissions: Get effective permissions for a user
Usage with Claude Code
Add to workspace .mcp.json:
Using npx (Recommended)
{
"mcpServers": {
"permit": {
"command": "npx",
"args": ["-y", "permit-mcp-server"],
"env": {
"PERMIT_API_KEY": "${PERMIT_API_KEY}",
"PERMIT_PROJECT_ID": "default"
}
}
}
}
Using local installation
{
"mcpServers": {
"permit": {
"command": "node",
"args": ["permit-mcp/dist/index.js"],
"env": {
"PERMIT_API_KEY": "${PERMIT_API_KEY}",
"PERMIT_PROJECT_ID": "default"
}
}
}
}
Development
# Build
pnpm build
# Watch mode
pnpm dev
# Type check
pnpm typecheck
# Run
pnpm start
Architecture
permit-mcp/
βββ src/
β βββ index.ts # MCP server entry point
β βββ permit-client.ts # HTTP client for Permit.io API
β βββ types/
β βββ permit.ts # Permit.io API types
βββ Dockerfile # Docker image
βββ docker-compose.local.yml # Docker Compose for development
βββ package.json
βββ tsconfig.json
βββ README.md
