{
  "markdown": "# SkillFM Beacon MCP\n\n**AI health, token usage, cost optimization, BYOK monitoring, and safe cleanup for MCP-capable agents.**\n\nSkillFM Beacon gives Claude Code, Cursor, Cline, Claude Desktop, VS Code Copilot, and other MCP clients a practical AI operations layer:\n\n- Check AI health and session status.\n- Inspect token usage and LLM spend.\n- Find cost-saving opportunities across provider setup, cache usage, batching, and context cleanup.\n- Monitor provider billing with BYOK keys stored in a local vault.\n- Audit slow-agent clutter such as stale worktrees, oversized logs, and bloated context.\n- Discover future SkillFM skills for content, social media, e-commerce, SEO/GEO, and workflow automation as they become available.\n\nThis repository is the public distribution shell for SkillFM's MCP marketplace listing. The canonical local runtime is [`@skillfm/local`](https://www.npmjs.com/package/@skillfm/local).\n\n## Quick Start\n\nUse SkillFM Beacon as an MCP stdio server:\n\n```bash\nnpx -y @skillfm/mcp@latest\n```\n\nEquivalent explicit form:\n\n```bash\nnpx -y @skillfm/mcp@latest mcp\n```\n\nFor MCP clients that accept JSON config:\n\n```json\n{\n  \"mcpServers\": {\n    \"skillfm\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@skillfm/mcp@latest\"]\n    }\n  }\n}\n```\n\n## Activation Path\n\nThe MCP package delegates to `@skillfm/local@latest`, so the same package can start the local sidecar and activate SkillFM in the current machine.\n\nStart the local sidecar:\n\n```bash\nnpx -y @skillfm/mcp@latest start\n```\n\nThe sidecar binds only to `127.0.0.1` and writes its service discovery file to:\n\n```text\n~/.skillfm/local.json\n```\n\nAgent-driven activation flow:\n\n1. Read the sidecar URL from stdout or `~/.skillfm/local.json`.\n2. Call `POST <sidecar_url>/activate/start`.\n3. Show the returned verification URL and real device code to the user.\n4. Poll `POST <sidecar_url>/activate/poll` until it returns `activated: true`.\n5. Use `GET <sidecar_url>/status`, `GET <sidecar_url>/skills`, or the MCP tools.\n\nDo not fabricate a placeholder code. The device code must come from `POST /activate/start`.\n\n## Useful Commands\n\n```bash\n# Start MCP stdio server\nnpx -y @skillfm/mcp@latest\n\n# Start local sidecar for current-chat activation\nnpx -y @skillfm/mcp@latest start\n\n# Show AI health checkup from the CLI\nnpx -y @skillfm/mcp@latest checkup\n\n# Detect supported local agent harnesses\nnpx -y @skillfm/mcp@latest safe detect\n\n# Install local SkillFM guidance into supported local agents after user approval\nnpx -y @skillfm/mcp@latest safe inject\n\n# Remove injected local guidance\nnpx -y @skillfm/mcp@latest safe uninstall\n```\n\n## What SkillFM Helps With\n\nSkillFM Beacon is for users who ask:\n\n- \"How many tokens did I use today?\"\n- \"Why is my AI bill going up?\"\n- \"Can I save money on OpenAI, Anthropic, DeepSeek, Qwen, or other LLM providers?\"\n- \"Is my agent getting slow because the context or workspace is bloated?\"\n- \"How do I safely connect a provider key without sending it to a SaaS dashboard?\"\n- \"What skills can my AI run for content, e-commerce, social media, SEO/GEO, or automation?\"\n\n## Security Model\n\n- **Local sidecar**: The activation sidecar listens on `127.0.0.1`, not the public network.\n- **BYOK vault**: Provider API keys are stored locally by `@skillfm/local`; agents do not read key values back.\n- **No private core in this repo**: This repository contains distribution metadata and a thin launcher only. Non-public platform implementation details are not included.\n- **User-controlled activation**: OAuth device-flow activation requires the user to approve the real device code in their own browser.\n- **Read-only cleanup first**: Cleanup audits are designed to report slow-agent clutter before any user-directed cleanup action.\n\nSee [PRIVACY.md](./PRIVACY.md) and [SECURITY.md](./SECURITY.md) for the public repository boundary.\n\n## Marketplace Keywords\n\nSkillFM Beacon is designed to be discoverable for:\n\n`MCP server`, `AI health checkup`, `token usage`, `LLM spend`, `AI cost optimizer`, `BYOK`, `local vault`, `agent monitoring`, `slow agent cleanup`, `context cleanup`, `Claude Code`, `Cursor`, `Cline`, `Claude Desktop`, `VS Code Copilot`, `OpenAI usage`, `Anthropic usage`, `DeepSeek usage`, `Qwen usage`.\n\n## Public Surface Boundary\n\nThis public package is intentionally small. It exists to make SkillFM easy to install from MCP marketplaces and agent directories while keeping core safety and platform logic private.\n\nPublic:\n\n- MCP registry metadata\n- npm launcher package\n- install docs\n- activation flow\n- security model\n- user-facing tool descriptions\n\nPrivate:\n\n- non-public platform implementation\n- proprietary evaluation internals\n- private prompts or configuration\n- customer data or logs\n- provider credentials\n\n## Marketplace Readiness\n\n- `server.json.name` matches `package.json.mcpName`.\n- The npm package is a thin public launcher for `@skillfm/local`.\n- `publishConfig.access` is set to `public` for scoped npm publishing.\n- Public docs avoid guaranteed income, passive income, and automatic earning claims.\n- The repository contains no backend service code, customer logs, provider keys, or non-public automation logic.\n\nSee [docs/MARKETPLACE-CHECKLIST.md](./docs/MARKETPLACE-CHECKLIST.md) before submitting to MCP registries or agent directories.\n\n## License\n\nMIT\n",
  "bytes": 5289,
  "sha": "4f7c6e0feaebd02a8bcd25ff653e9114eceb2e474c6d7ea252b8d5345b504077",
  "repo_slug": "ericm1018/skillfm-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ericm1018_skillfm_c0593deb/readme"
}