@yojinhq/jintel-mcp

Model Context Protocol (MCP) server for the Jintel intelligence API. Exposes Jintel's market data, news, regulatory, and risk screening capabilities as MCP tools so Claude Desktop, Claude Code, and other MCP clients can query Jintel directly.

Install

npm install -g @yojinhq/jintel-mcp

Or run without installing:

npx -y @yojinhq/jintel-mcp

Configuration

The server runs in one of two auth modes — set exactly one:

| Variable | Mode | Description | |-----------------------------|-----------|-------------------------------------------------------------------------------------| | JINTEL_API_KEY | Bearer | Org-issued API key. Get one at api.jintel.ai. | | JINTEL_WALLET_PRIVATE_KEY | x402 | 0x-prefixed 32-byte hex. Pays per query in USDC on Base — keyless / agent-native. | | JINTEL_X402_MAX_VALUE | x402 opt. | Max atomic USDC per query (6 decimals). Defaults to 1000000 (= $1). | | JINTEL_BASE_URL | both | Override base URL (default: https://api.jintel.ai/api). |

JINTEL_API_KEY wins if both are set. The wallet path requires USDC on Base mainnet (chain 8453); top up at any USDC on-ramp before starting the server.

Claude Desktop — Bearer mode

Add to claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jintel": {
      "command": "npx",
      "args": ["-y", "@yojinhq/jintel-mcp"],
      "env": {
        "JINTEL_API_KEY": "jk_live_your_key_here"
      }
    }
  }
}

Claude Desktop — wallet mode (x402, no API key)

{
  "mcpServers": {
    "jintel": {
      "command": "npx",
      "args": ["-y", "@yojinhq/jintel-mcp"],
      "env": {
        "JINTEL_WALLET_PRIVATE_KEY": "0xabc...",
        "JINTEL_X402_MAX_VALUE": "5000000"
      }
    }
  }
}

Restart Claude Desktop. You should see the Jintel tools available in the tools menu.

Claude Code

claude mcp add jintel -- npx -y @yojinhq/jintel-mcp
# Then set the API key in the resulting config, or export JINTEL_API_KEY in your shell.

Tools

Core

These five tools form the core bundle — always loaded in dynamic mode. Other tools live in the bundles listed below and load on demand via jintel_load_bundle (or all-at-once in static mode).

| Tool | Purpose | |---------------------|------------------------------------------------------------------------------------| | jintel_quote | Real-time quotes for stocks, crypto, indices | | jintel_search | Search entities by name / ticker / keyword | | jintel_financials | Income statement / balance sheet / cash flow | | jintel_news | Recent news articles with sentiment + source filters | | jintel_query | Compact dispatcher — single tool that routes to any per-entity sub-graph by kind |

Per-entity sub-graphs

| Tool | Purpose | |----------------------------------|------------------------------------------------------------------| | jintel_news | Recent news articles with sentiment + source filters | | jintel_research | Web research articles | | jintel_sentiment | Aggregated social sentiment + 24h momentum | | jintel_social | Raw Reddit / Twitter mentions and top comments | | jintel_discussions | Hacker News stories filtered by points / comments | | jintel_predictions | Polymarket / Kalshi prediction-market events | | jintel_risk_signals | Sanctions, litigation, regulatory actions, adverse media, PEP | | jintel_regulatory | SEC filings + sanctions matches + campaign finance | | jintel_periodic_filings | 10-K / 10-Q / 8-K filings with summaries | | jintel_technicals | RSI, MACD, BB, EMA, SMA, ATR, ADX, MFI, VWAP, etc | | jintel_derivatives | Futures curve + options chain (filterable by strike, OI, volume) | | jintel_short_interest | Bi-monthly short interest reports | | jintel_ownership | Institutional / insider / retail breakdown | | jintel_top_holders | Top institutional holders by shares | | jintel_institutional_holdings | 13F holdings by filer CIK | | jintel_insider_trades | Form 4 transactions (officers, directors, 10% owners) | | jintel_financials | Income statement / balance sheet / cash flow | | jintel_executives | Officers + compensation | | jintel_earnings_calendar | Past + upcoming earnings reports with EPS surprise | | jintel_earnings_press_releases | Earnings press releases with summaries | | jintel_segmented_revenue | Revenue by product / segment / geography / customer | | jintel_analyst_consensus | Wall Street recommendation + price target | | jintel_clinical_trials | Clinical trial registrations (filter by phase / status) | | jintel_fda_events | FDA adverse events + drug / device recalls | | jintel_litigation | Active + historical lawsuits | | jintel_government_contracts | US government contract awards |

Macro & cross-sectional

| Tool | Purpose | |---------------------------|-----------------------------------------------------------| | jintel_gdp | GDP time series by country (REAL / NOMINAL / FORECAST) | | jintel_inflation | CPI / inflation time series by country | | jintel_interest_rates | Policy interest rates by country | | jintel_sp500_multiples | S&P 500 PE / Shiller PE / dividend yield / earnings yield | | jintel_macro_series | FRED-style time series by ID (single or batch) | | jintel_fama_french | Fama-French 3- or 5-factor returns | | jintel_campaign_finance | US PAC / candidate committee data |

Tool surface modes

The server adapts its tool surface to the client to keep context lean without hiding capability.

Auto mode (default)

When JINTEL_TOOLSET is unset, the server inspects clientInfo.name from the MCP initialize exchange:

• MCP-native clients that honor notifications/tools/list_changed (Claude Desktop, Cursor, Cline, MCP Inspector, Continue) see 6 core tools at boot: jintel_search, jintel_quote, jintel_financials, jintel_news, jintel_query, jintel_load_bundle. Additional tools load on demand via jintel_load_bundle({name: "regulatory"}), and the client sees them appear after a tools/list_changed notification.
• Other clients (LangChain bridges, agentic.market scrapers, benchmark harnesses) see all 42 tools up-front. No notifications are emitted; the surface is fixed for the connection.

Forced mode (env override)

JINTEL_TOOLSET overrides auto-detection:

| Value | Effect | |---------------------------|-----------------------------------------------| | (unset) | Auto-detect from clientInfo.name. | | all | Static, all 42 tools. | | core | Dynamic, core only at boot, bundles loadable. | | core,markets,regulatory | Static, named subset. | | dynamic | Explicitly dynamic regardless of client. |

Custom allowlist

JINTEL_DYNAMIC_CLIENTS (comma-separated) overrides the default allowlist of dynamic-capable clients. Useful for internal bridges that implement tools/list_changed properly:

JINTEL_DYNAMIC_CLIENTS=claude-ai,my-internal-agent

Bundles

| Bundle | Tools | |-------------|-----------------------------------------------------------------------------------------------------------------------------------------------| | core | search, quote, financials, news, query, load_bundle | | markets | price_history, technicals, derivatives, market_status, fama_french, short_interest, sp500_multiples | | ownership | institutional_holdings, top_holders, ownership, insider_trades | | corporate | executives, earnings_calendar, earnings_press_releases, segmented_revenue, analyst_consensus | | regulatory | sanctions_screen, regulatory, periodic_filings, risk_signals, litigation, fda_events, clinical_trials, government_contracts, campaign_finance | | macro | gdp, inflation, interest_rates, macro_series | | qualitative | research, sentiment, social, discussions, predictions | | enrich | enrich, batch_enrich |

Field projection

Four data tools accept an optional fields array to limit response size:

• jintel_financials
• jintel_segmented_revenue
• jintel_institutional_holdings
• jintel_insider_trades

Omit the parameter to get all fields (today's behavior). Unknown field names return an error listing the valid set.

Migrating from 0.2.x

Set JINTEL_TOOLSET=all to preserve the flat tool surface — you'll see 42 tools total: the original 41 plus jintel_load_bundle (which is a no-op in static mode but always listed). No other behavior changes.

Local dev

pnpm install
pnpm --filter @yojinhq/jintel-mcp build
JINTEL_API_KEY=... node packages/mcp/dist/bin.js

Talk to it directly:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | JINTEL_API_KEY=dummy node packages/mcp/dist/bin.js

License

MIT