talon-mcp

library0.17.4jsnpmunverified

An MCP (Model Context Protocol) server for automated Talon Auth setup. Version 0.17.4 requires Node.js >= 22. It allows AI assistants to handle account creation, organization and application management, and framework-aware integration. Key differentiators: uses device-based JWT tokens stored locally, integrates with multiple frontend/backend frameworks via a single web component and createVerifier(), and is part of the Feathers ecosystem. Release cadence: part of a monorepo with ongoing development.

auth-security

npm install talon-mcp

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · TALON-MCP

talon-mcp

auth-securityjavascriptv0.17.4

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default (CLI)

✓ npx talon-mcp

✗ npm i -g talon-mcp && talon-mcp

Use npx for immediate execution; global install is discouraged.

MCP server config

✓ { "mcpServers": { "talon-mcp": { "command": "npx", "args": ["talon-mcp"] } } }

✗ { "mcpServers": { "talon-mcp": { "command": "talon-mcp" } } }

Must use 'command/npx' and 'args' array, not direct command.

Claude Code command

✓ claude mcp add talon-mcp npx talon-mcp

✗ claude mcp add talon-mcp talon-mcp

Include 'npx' as part of the command.

Auth config

✓ import { createVerifier } from '@talon/auth'

✗ import createVerifier from '@talon/auth'

createVerifier is a named export. This is for backend integration.

Shows how to set up the MCP server in Claude Desktop and initiate Talon Auth integration.

// Configure Claude Desktop by adding to ~/Library/Application Support/Claude/claude_desktop_config.json: { "mcpServers": { "talon-mcp": { "command": "npx", "args": ["talon-mcp"] } } } // Then restart Claude and ask: "Add Talon Auth to my app" // The assistant will: // 1. Check auth status // 2. Send login code to your email (via login_start) // 3. Verify code (via login_verify) // 4. List/create organization // 5. Create application with allowed referrers (e.g., http://localhost:5173) // 6. Inspect codebase and install packages, write integration code using <talon-login> and createVerifier()

talon-mcp --version

Debug

Known issues

gotchaThe MCP server stores a device token in .auth.json. If you delete or modify this file, you'll need to log in again.

fix

Do not delete .auth.json; if lost, simply re-run the login flow via Claude.

affects: >=0.0.0

gotchaThe integration code generated uses <talon-login> web component and createVerifier(). Ensure your project supports these or that the assistant adapts accordingly.

fix

Use the get_docs tool to fetch the latest integration docs for your framework.

affects: >=0.0.0

breakingVersion 0.17.4 may have breaking changes from previous versions due to monorepo structure. Check changelog if upgrading.

fix

Review the repository's release notes for migration steps.

affects: <0.17.0

Errors

Common errors & fixes

Error: Cannot find module 'talon-mcp'

npx cannot find the package due to network issues or misspelling.

fix

Ensure you are using 'npx talon-mcp' (all lowercase) and have internet access. Try 'npx talon-mcp@latest'.

claude mcp add: command not found

Claude Code CLI is not installed or outdated.

fix

Install the latest Claude Code CLI: 'npm i -g @anthropic-ai/claude-code'

ValidationError: 'args' must be an array

Incorrect format in claude_desktop_config.json for MCP server args.

fix

Use the correct format: {"command": "npx", "args": ["talon-mcp"]}

Error: Not authenticated. Please log in.

No .auth.json file or expired token.

fix

Initiate login again using the assistant or call login_start tool directly via MCP.

Upgrade

Version history

0.17.4latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

16 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/feathersdev/monorepo ↗

packagehttps://www.npmjs.com/package/talon-mcp ↗

homepagehttps://talon.codes ↗