alphai-claude-skills

July 8, 2026 · View on GitHub

Ready-to-use Claude Code skills for the AlphaAI MCP server — relevance-scored, ticker-linked financial news plus SEC Form 4 / 13F insider data, straight inside your agent.

Each skill is a small SKILL.md that teaches Claude when and how to call the alphai MCP tools for a concrete finance workflow — so you can just ask "brief me on NVDA" or "what's moving right now?" and get a structured answer instead of a raw tool dump.

SkillUse it when you want…Tools it leans on
stock-briefA situational brief on one ticker — top news, insider activity, what to watchalphai_ticker_news, alphai_trending, alphai_article
market-pulse"What's moving right now / today?" across the marketalphai_actionable_now, alphai_trending
insider-radarA scan of insider buying/selling for a ticker or watchlistalphai_insider_news
peer-readacrossA two-ticker comparison and cross-read (e.g. NVDA vs AMD)alphai_pair_analysis
manage-alertsTo list / add / remove ticker news-alert subscriptionsalphai_alerts_* (Basic/Pro)

1. Connect the alphai MCP to Claude Code

One line — Claude Code prompts for OAuth on connect and opens your browser to authorize (OAuth 2.1, no API key to paste; re-authenticate any time with /mcp):

claude mcp add --transport http alphai https://mcp.alphai.io/mcp

Headless box (no browser)? Use an alphai API key from alphai.io/account as a static Bearer header instead:

claude mcp add --transport http alphai https://mcp.alphai.io/mcp \
  --header "Authorization: Bearer ak_live_YOUR_KEY"

The Free tier is 100 tool calls/day (20/min burst) with no card. The MCP is read-only news data; nothing here places trades or touches your account beyond your own alert subscriptions. See alphai.io/mcp for other clients (Claude Desktop, Cursor, VS Code, Gemini, …).

2. Install the skills

Skills are just folders. Copy the ones you want into a skills directory Claude Code reads:

# Personal — available in every project on this machine
cp -r skills/* ~/.claude/skills/

# …or per-project — checked in for your team
mkdir -p .claude/skills && cp -r skills/* .claude/skills/

Claude Code discovers them automatically. Run /help or just start a chat — when your request matches a skill's description, Claude invokes it.

3. Use them

You don't call skills explicitly; you describe what you want and Claude picks the right one:

  • "Give me a brief on TSLA." → stock-brief
  • "What's the big story in the market this morning?" → market-pulse
  • "Any notable insider buying in PLTR lately?" → insider-radar
  • "Compare NVDA and AMD — what's the read-across?" → peer-readacross
  • "Subscribe me to high-relevance AAPL earnings alerts." → manage-alerts

Tool reference

All 11 tools the skills can reach (full schemas at alphai.io/mcp):

ToolWhat it returns
alphai_news_searchFilter the enriched feed (tickers, category, dates, min_relevance) — no free-text query.
alphai_ticker_newsLatest news for one ticker (insider included by default).
alphai_trendingTop news from the last 48h ranked by relevance.
alphai_actionable_nowBreaking, decision-grade news from the last few hours.
alphai_insider_newsSEC Form 4 + 13F ownership-change news.
alphai_pair_analysisNews naming two tickers, plus each one's own recent news.
alphai_articleOne article by uid, with full enrichment.
alphai_tickersList/search supported tickers — US stocks, ETFs, crypto & foreign listings.
alphai_alerts_listYour active alert subscriptions (Basic/Pro).
alphai_alerts_subscribeAdd/update a ticker alert (Basic/Pro).
alphai_alerts_unsubscribeDisable a ticker alert (Basic/Pro).

Relevance score is the enricher's 1–10 rating of how much a story matters for its tickers; most tools default to a floor of 4. Categories (14): earnings, mergers_acquisitions, regulation, macro_economy, sector_analysis, market_movers, technology, commodities, crypto, ipo, geopolitics, insider, corporate_actions, other.

License

MIT