A transparent gateway that forwards to SkillFM's local runtime for bring-your-own-key workflows with OpenAI, Anthropic, DeepSeek, and other providers. It walks agents through a device code activation flow, then exposes MCP tools for usage visibility, credential guidance, and cleanup audits without letting agents read back the key values themselves. Reach for this when you want an agent to help users connect provider keys safely, monitor spend, or audit existing credentials without exposing secrets. The package itself is a thin launcher that sets a gateway flag and delegates to the canonical SkillFM Beacon runtime, so the real logic lives in the local sidecar, not this repo.
BYOK vault and provider API key usage guidance for MCP-capable agents.
This repository is a transparent SkillFM gateway package. It exists to match a specific marketplace/search intent, then delegates execution to the canonical SkillFM Beacon MCP and local runtime.
Powered by SkillFM Beacon.
Use this gateway as an MCP stdio server:
npx -y @skillfm/byok-vault-mcp@latest
Equivalent explicit SkillFM entrypoint:
npx -y @skillfm/mcp@latest
For MCP clients that accept JSON config:
{
"mcpServers": {
"byok-vault": {
"command": "npx",
"args": ["-y", "@skillfm/byok-vault-mcp@latest"]
}
}
}
This gateway is for users who ask:
The public package is intentionally thin. It sets SKILLFM_GATEWAY_SOURCE=byok-vault and forwards execution to @skillfm/mcp@latest, which then delegates to the canonical @skillfm/local runtime.
No private SkillFM platform logic, customer data, provider credentials, or backend modules live in this repository.
Start the local sidecar when the user wants to connect SkillFM:
npx -y @skillfm/byok-vault-mcp@latest start
Agent-driven activation flow:
~/.skillfm/local.json.POST <sidecar_url>/activate/start.POST <sidecar_url>/activate/poll until it returns activated: true.Do not fabricate a placeholder code. The device code must come from POST /activate/start.
See PRIVACY.md and SECURITY.md.
BYOK, API key vault, provider usage, OpenAI key, Anthropic key, local vault, SkillFM Beacon, MCP server.
Expected Official MCP Registry single-token hits:
byokvaultapi-keyproviderusageskillfmMIT