mcp-who-am-i

This MCP server, mcp-who-am-i, reports information from the Authorization header by decoding the JWT and returning selected payload fields related to authentication. It can be used to quickly inspect who a request claims to be by exposing the decoded JWT contents via the MCP endpoint. You can run it locally with npx or via Docker, and then connect to its HTTP MCP endpoint to send requests with an Authorization header containing a JWT. The server responds with structured data about the decoded token, making it easy to verify claims like subject, issuer, expiration, and custom JWT fields. If you are using the public version, you can also access pre-built endpoints such as /who-am-i-public/mcp for unauthenticated usage, or /who-am-i/mcp for authenticated usage, depending on the deployment.

Prerequisites:

• Node.js and npm (for npx usage) or Docker (for container usage).
• Internet access to fetch the MCP server package from the registry.

Option A: Install and run with npx

1. Ensure Node.js is installed on your system.

2. Run the MCP server with:

   npx @hyprmcp/mcp-who-am-i@latest

   This will fetch and start the MCP server in your environment.

Option B: Run with Docker

1. Ensure Docker is installed and running.

2. Start the server container:

   docker run --rm -p 3000:3000 ghcr.io/hyprmcp/mcp-who-am-i

   The container exposes the MCP endpoint on port 3000.

Note: The repository README also mentions optional integration through various editors and tools by pointing to the same MCP endpoint; ensure you use the appropriate URL (for example, https://demo.hyprmcp.cloud/who-am-i/mcp) when using remote/demo deployments.

Tips and caveats:

• If you are decoding JWTs, ensure the Authorization header is set to: Authorization: Bearer <your_jwt_token>.
• For local testing, you can map the server's port to 3000 as shown in the Docker example or adjust the port if needed.
• If you encounter CORS or schema issues, verify the MCP endpoint path (e.g., /mcp) and confirm whether the deployment requires authentication or exposes a public variant (as shown in the README with /who-am-i-public/mcp).
• The npm package name for the Node.js-based server is @hyprmcp/mcp-who-am-i; use the exact tag if you rely on a specific release.
• When using npx with @latest, you’ll get the most recent release; pin versions if you want reproducible setups.