@authn8/mcp-server

MCP server that provides AI agents access to Authn8 2FA codes via PAT authentication.

Docker

docker run -e AUTHN8_API_KEY=pat_xxx ghcr.io/authn8/mcp-server

Environment Variables

Available Tools

list_accounts

Returns all 2FA accounts accessible to this token.

Example response:

[
  {
    "id": "924c52a6-4457-4970-a39f-4dc620217683",
    "name": "AWS Production",
    "issuer": "amazon.com"
  }
]

get_otp

Generates a TOTP code for a specific account.

Parameters:

• account_id (string, optional) - UUID of the account
• account_name (string, optional) - Name to search for (partial match)

Provide either account_id or account_name. If multiple accounts match the name, the tool returns a list of matches.

Example response:

{
  "account": "AWS Production",
  "code": "483920"
}

whoami

Returns information about the current token.

Example response:

{
  "business": "Bytecode Solutions",
  "token_name": "MCP Server 2",
  "scoped_groups": ["HR"],
  "account_count": 1,
  "expires_at": "2025-12-25T23:59:59Z"
}

Links

• Authn8 - Create an account and manage 2FA tokens
• GitHub Repository

Prerequisites

• An Authn8 account
• A Personal Access Token (PAT) created in the Authn8 dashboard

Quick Start

npx @authn8/mcp-server

Set the AUTHN8_API_KEY environment variable to your PAT token.

Configuration

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "authn8": {
      "command": "npx",
      "args": ["-y", "@authn8/mcp-server"],
      "env": {
        "AUTHN8_API_KEY": "pat_your_token_here"
      }
    }
  }
}

Claude Code (CLI)

Add to your Claude Code configuration file:

macOS: ~/.claude.json Windows: %USERPROFILE%\.claude.json

{
  "mcpServers": {
    "authn8": {
      "command": "npx",
      "args": ["-y", "@authn8/mcp-server"],
      "env": {
        "AUTHN8_API_KEY": "pat_your_token_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "authn8": {
      "command": "npx",
      "args": ["-y", "@authn8/mcp-server"],
      "env": {
        "AUTHN8_API_KEY": "pat_your_token_here"
      }
    }
  }
}