2faa-mcp

@2faa/mcp-server

MCP (Model Context Protocol) server for generating and verifying TOTP 2FA codes. Allows AI agents to handle two-factor authentication programmatically.

Tools

generate_totp

Generate a TOTP code from a secret key.

Parameters:

• secret (required) — Base32 encoded secret key or otpauth:// URI
• digits — Number of digits (default: 6)
• period — Time period in seconds (default: 30)
• algorithm — SHA1 | SHA256 | SHA512 (default: SHA1)

Returns: Current code, next code, seconds remaining, and configuration details.

verify_totp

Verify if a TOTP code is valid for a given secret.

Parameters:

• secret (required) — Base32 encoded secret key or otpauth:// URI
• code (required) — The TOTP code to verify
• window — Number of time windows to check before/after current (default: 1)

Returns: Whether the code is valid and the time delta.

Setup

Build

cd mcp
npm install
npm run build

Claude Code

Add to your Claude Code MCP settings (~/.claude/settings.json or project .mcp.json):

{
  "mcpServers": {
    "2faa": {
      "command": "node",
      "args": ["/absolute/path/to/2faa/mcp/dist/index.js"]
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "2faa": {
      "command": "node",
      "args": ["/absolute/path/to/2faa/mcp/dist/index.js"]
    }
  }
}

npx (after publishing)

{
  "mcpServers": {
    "2faa": {
      "command": "npx",
      "args": ["-y", "@2faa/mcp-server"]
    }
  }
}

Example Usage

Once configured, ask your AI agent:

• "Generate a TOTP code for secret JBSWY3DPEHPK3PXP"
• "Verify code 123456 against secret JBSWY3DPEHPK3PXP"
• "Generate a 2FA code from this otpauth URI: otpauth://totp/GitHub:user?secret=ABCDEF..."

License

MIT