@feathersdev/talon-mcp

0.17.4 verified Sat Apr 25 auth: no javascript

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.

Common errors

error Error: Cannot find module 'talon-mcp' ↓

cause 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'.

error claude mcp add: command not found ↓

cause Claude Code CLI is not installed or outdated.

fix

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

error ValidationError: 'args' must be an array ↓

cause Incorrect format in claude_desktop_config.json for MCP server args.

fix

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

error Error: Not authenticated. Please log in. ↓

cause No .auth.json file or expired token.

fix

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

Warnings

gotcha The 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.

gotcha The 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.

breaking Version 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.

Install

npm install talon-mcp

yarn add talon-mcp

pnpm add talon-mcp

Imports

default (CLI)
wrong
```
npm i -g talon-mcp && talon-mcp
```
correct
```
npx talon-mcp
```
Use npx for immediate execution; global install is discouraged.

MCP server config

wrong

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

correct

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

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

Claude Code command

wrong

claude mcp add talon-mcp talon-mcp

correct

claude mcp add talon-mcp npx talon-mcp

Include 'npx' as part of the command.

Auth config

wrong

import createVerifier from '@talon/auth'

correct

import { createVerifier } from '@talon/auth'

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

Quickstart

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()