fintel-data

# Fintel Data Skill Fintel ([fintel.io](https://fintel.io)) is an institutional-grade market intelligence platform. Its strongest datasets are the ones most other providers lack: **short interest, borrow rates, short volume, fails-to-deliver, 13F institutional ownership, and insider transactions**. Fintel exposes two surfaces backed by the same data contract: | Surface | Endpoint | Auth | Best for | |---|---|---|---| | **REST** | `https://api.fintel.io/v1/*` | `X-API-KEY` header | Default — curl from any CLI agent | | **MCP** | `https://mcp.fintel.io/mcp` | `X-API-KEY` header | MCP-native clients, tool auto-discovery | Both require a Fintel API key. **This skill is READ-ONLY** — only call GET endpoints. The API also exposes write endpoints (create/delete stock lists, alert subscriptions, teams); do not call them. --- ## Step 1: Resolve FINTEL_API_KEY The skill resolves `FINTEL_API_KEY` in this order: 1. `FINTEL_API_KEY` environment variable 2. `FINTEL_API_KEY` in `.env` in the current directory 3. `FINTEL_API_KEY` in `.env` at the git repo root (so a worktree inherits the key from the main checkout) ``` !`if [ -n "$FINTEL_API_KEY" ]; then echo "KEY_FROM_ENV_VAR"; elif [ -f .env ] && grep -qE "^FINTEL_API_KEY=" .env; then echo "KEY_FROM_LOCAL_DOTENV:$(pwd)/.env"; else GIT_COMMON=$(git rev-parse --path-format=absolute --git-common-dir 2>/dev/null); if [ -n "$GIT_COMMON" ]; then ROOT=$(dirname "$GIT_COMMON"); if [ -f "$ROOT/.env" ] && grep -qE "^FINTEL_API_KEY=" "$ROOT/....