starkfi-agent-skills
v1.0.0
Published
Agent skills and one-command setup for StarkFi MCP (Cursor, Claude Desktop, Claude Code)
Maintainers
Readme
starkfi-agent-skills
Cursor Agent Skills plus a one-shot setup that copies those skills and registers the StarkFi MCP server ([starkfi-mcp](https://www.npmjs.com/package/starkfi-mcp)) in Cursor and Claude Desktop (macOS). It aligns with the starkfi-mcp-agent tool catalog and StarkFi docs (including Getting started / KYC).
Quick start
npx starkfi-agent-skills setupOptional: export your key first so the script can write it into MCP configs:
export STARKFI_API_KEY="your_key_here"
npx starkfi-agent-skills setupNon-interactive:
STARKFI_API_KEY="your_key_here" npx starkfi-agent-skills setup --yesAfter setup, fully restart Cursor (and Claude Desktop if you use it) so MCP changes load.
What gets configured
| Target | What the setup does |
|--------|---------------------|
| Cursor | Copies agent-skills/* → ~/.cursor/skills/; merges ~/.cursor/mcp.json → mcpServers.starkfi running npx -y starkfi-mcp |
| Claude Desktop (macOS) | Creates or updates ~/Library/Application Support/Claude/claude_desktop_config.json with the same starkfi entry |
| Claude Code | Optional: --claude-code-project writes .mcp.json in the current directory using "${STARKFI_API_KEY}" expansion (Claude Code MCP). Alternatively run: claude mcp add --transport stdio --scope user --env STARKFI_API_KEY=$STARKFI_API_KEY starkfi -- npx -y starkfi-mcp |
Flags
| Flag | Effect |
|------|--------|
| --yes / -y | No prompt; use STARKFI_API_KEY from the environment |
| --dry-run | Print actions only (still reads disk) |
| --skills-project | Copy skills to ./.cursor/skills instead of ~/.cursor/skills |
| --claude-code-project | Merge ./.mcp.json for Claude Code project scope |
| --no-cursor | Do not change ~/.cursor/mcp.json |
| --no-claude-desktop | Do not change Claude Desktop config |
Auto-run on npm install
STARKFI_SKILLS_AUTO_SETUP=1 npm install starkfi-agent-skillsCI / automation: set SKIP_STARKFI_SKILLS_POSTINSTALL=1 to silence the post-install hint.
Skills included
See agent-skills/README.md. In Cursor, skills live under ~/.cursor/skills/<skill-name>/SKILL.md (not skills-cursor, which is reserved for Cursor-built-in content).
Security
Treat STARKFI_API_KEY like a production secret. Prefer MCP env in the host UI or OS keychain helpers over committing keys. If you use .mcp.json with ${STARKFI_API_KEY}, keep secrets out of git and document how teammates export the variable.
License
MIT — see LICENSE.
