JWT Auditor MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@JWT Auditor MCP Server decode this JWT and check for vulnerabilities"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
JWT Auditor MCP Server
This project provides an MCP server exposing advanced JWT auditing tools, inspired by JWTAuditor. It is designed for use with Claude Desktop, Cursor, and other MCP-compatible clients.
Features
JWT Decoder: Decodes JWT header, payload, and signature.
JWT Analyzer: Detects vulnerabilities (alg=none, weak algs, missing claims, header injection, sensitive data, etc.).
JWT Secret Bruteforcer: Attempts to brute-force HS256/HS384/HS512 secrets using a wordlist.
JWT Generator/Editor: Create and sign JWTs (HS* and RS* support).
Related MCP server: jwt-doctor-mcp
Quickstart
1. Install dependencies (using uv)
uv pip install -r pyproject.toml2. Run the MCP server
uv run server.py3. Configure Claude Desktop (or Cursor)
Add the following to your Claude Desktop mcpServers.json (or merge into your config):
{
"mcpServers": {
"JWT Auditor MCP": {
"type": "stdio",
"command": "uv",
"args": ["run", "server.py"],
"cwd": "/Users/haji/mcp-servers/jwtAuditor-Mcp"
}
}
}Make sure the
cwdpath matches your project directory.This will launch the server in the correct environment using
uv.
4. Example mcp.json for MCP Inspector or other clients
If you want to use the MCP Inspector or another tool that requires an mcp.json config, use:
{
"mcpServers": {
"jwt-auditor": {
"type": "stdio",
"command": "uv",
"args": ["run", "server.py"],
"cwd": "/Users/haji/mcp-servers/jwtAuditor-Mcp"
}
}
}Security
All JWT operations are performed locally.
No tokens or secrets are sent to any external service.
Credits
Inspired by JWTAuditor
Built with MCP Python SDK
Available Tools
4 toolsjwt_analyzeC
Analyze a JWT for common vulnerabilities and issues.
Inputs: token (required).
jwt_bruteforceA
Bruteforce the secret for HS256/HS384/HS512 JWTs using a common wordlist or a custom one.
Inputs: token (required), wordlist.
jwt_decodeA
Decode a JWT and return its header, payload, and signature (no verification).
Inputs: token (required).
jwt_generateC
Generate a JWT with the given header, payload, algorithm, and key (HS* or RS*).
Inputs: header (required), payload (required), alg (required), key (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: jwt_analyze for vulnerability assessment, jwt_bruteforce for secret cracking, jwt_decode for raw decoding, and jwt_generate for token creation. There is no overlap in functionality, making it easy for an agent to select the correct tool for a specific task.
All tool names follow a consistent 'jwt_' prefix with a descriptive action suffix (analyze, bruteforce, decode, generate), using snake_case uniformly. This predictable pattern enhances readability and reduces confusion for agents.
With 4 tools, the server is well-scoped for JWT auditing, covering essential operations like analysis, decoding, generation, and brute-forcing. Each tool earns its place without being too sparse or overwhelming, fitting typical use cases in this domain.
The toolset provides strong coverage for core JWT auditing tasks, including decode, generate, analyze, and brute-force. A minor gap exists in lacking a tool for verifying JWTs with known keys, which could be useful but is not critical for the stated purpose, as agents can work around this.
Maintenance
Related MCP Connectors
Developer utilities over MCP: Base64 encode and decode, decode JWTs, format JSON, do percentages.
238+ dev tools via MCP: JSON, QR, PDF, DNS, hash, UUID, code review, JWT, SSL, WHOIS, and more
Hash passwords with bcrypt and issue/verify JWT session tokens over A2A + MCP.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server that provides AI clients with 26 security and developer tools, enabling tasks like JWT decoding, HTTP header analysis, and phishing URL inspection.-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to audit JSON Web Tokens (JWTs) and other token formats for security vulnerabilities, including HMAC secret cracking, live JWKS verification, and CVE fingerprinting.MIT
- AlicenseAqualityDmaintenanceProvides security audit primitives for MCP servers, agent tool schemas, and system prompts, along with pentest utilities like JWT inspection and HTTP diffing.14MIT
- AlicenseNot gradedqualityAmaintenanceEnables authorized penetration testers to run reconnaissance, scanning, brute-force, exploitation, traffic capture, wordlist generation, and client-report workflows through MCP clients, with stdio/HTTP/SSE transport and OIDC bearer authentication.157 npmGPL 3.0