{"id":18841,"library":"talon-mcp","title":"@feathersdev/talon-mcp","description":"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.","status":"active","version":"0.17.4","language":"javascript","source_language":"en","source_url":"git://github.com/feathersdev/monorepo","tags":["javascript","featherscloud","mcp"],"install":[{"cmd":"npm install talon-mcp","lang":"bash","label":"npm"},{"cmd":"yarn add talon-mcp","lang":"bash","label":"yarn"},{"cmd":"pnpm add talon-mcp","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Use npx for immediate execution; global install is discouraged.","wrong":"npm i -g talon-mcp && talon-mcp","symbol":"default (CLI)","correct":"npx talon-mcp"},{"note":"Must use 'command/npx' and 'args' array, not direct command.","wrong":"{\n  \"mcpServers\": {\n    \"talon-mcp\": {\n      \"command\": \"talon-mcp\"\n    }\n  }\n}","symbol":"MCP server config","correct":"{\n  \"mcpServers\": {\n    \"talon-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"talon-mcp\"]\n    }\n  }\n}"},{"note":"Include 'npx' as part of the command.","wrong":"claude mcp add talon-mcp talon-mcp","symbol":"Claude Code command","correct":"claude mcp add talon-mcp npx talon-mcp"},{"note":"createVerifier is a named export. This is for backend integration.","wrong":"import createVerifier from '@talon/auth'","symbol":"Auth config","correct":"import { createVerifier } from '@talon/auth'"}],"quickstart":{"code":"// Configure Claude Desktop by adding to ~/Library/Application Support/Claude/claude_desktop_config.json:\n{\n  \"mcpServers\": {\n    \"talon-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"talon-mcp\"]\n    }\n  }\n}\n\n// Then restart Claude and ask:\n\"Add Talon Auth to my app\"\n\n// The assistant will:\n// 1. Check auth status\n// 2. Send login code to your email (via login_start)\n// 3. Verify code (via login_verify)\n// 4. List/create organization\n// 5. Create application with allowed referrers (e.g., http://localhost:5173)\n// 6. Inspect codebase and install packages, write integration code using <talon-login> and createVerifier()","lang":"javascript","description":"Shows how to set up the MCP server in Claude Desktop and initiate Talon Auth integration."},"warnings":[{"fix":"Do not delete .auth.json; if lost, simply re-run the login flow via Claude.","message":"The MCP server stores a device token in .auth.json. If you delete or modify this file, you'll need to log in again.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Use the get_docs tool to fetch the latest integration docs for your framework.","message":"The integration code generated uses <talon-login> web component and createVerifier(). Ensure your project supports these or that the assistant adapts accordingly.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Review the repository's release notes for migration steps.","message":"Version 0.17.4 may have breaking changes from previous versions due to monorepo structure. Check changelog if upgrading.","severity":"breaking","affected_versions":"<0.17.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Ensure you are using 'npx talon-mcp' (all lowercase) and have internet access. Try 'npx talon-mcp@latest'.","cause":"npx cannot find the package due to network issues or misspelling.","error":"Error: Cannot find module 'talon-mcp'"},{"fix":"Install the latest Claude Code CLI: 'npm i -g @anthropic-ai/claude-code'","cause":"Claude Code CLI is not installed or outdated.","error":"claude mcp add: command not found"},{"fix":"Use the correct format: {\"command\": \"npx\", \"args\": [\"talon-mcp\"]}","cause":"Incorrect format in claude_desktop_config.json for MCP server args.","error":"ValidationError: 'args' must be an array"},{"fix":"Initiate login again using the assistant or call login_start tool directly via MCP.","cause":"No .auth.json file or expired token.","error":"Error: Not authenticated. Please log in."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}