Jintel SDK

Public SDK monorepo for the Jintel intelligence API — a GraphQL endpoint that unifies market data, news, regulatory filings, sanctions screening, macro indicators, and more behind one key.

Get an API key at api.jintel.ai.

Packages

All four wrap the same GraphQL API.

Array sub-graphs accept a per-field filter argument — generic date/limit/sort via ArrayFilterInput, plus domain-specific inputs for SEC filings (FilingsFilterInput), risk signals (RiskSignalFilterInput), futures (FuturesCurveFilterInput), and options chains (OptionsChainFilterInput). See packages/client/README.md for examples.

Auth modes

Every package supports two auth modes — set exactly one:

• Bearer (API key) — JINTEL_API_KEY=jk_live_…, get one at api.jintel.ai. Org-billed via plan + credit pool.
• x402 wallet (keyless) — JINTEL_WALLET_PRIVATE_KEY=0x…, pays per query in USDC on Base (~$0.015 floor). Optional JINTEL_X402_MAX_VALUE caps spend per query (atomic USDC, default 1000000 = $1). Agent-native: no signup, no Bearer — the payer wallet auto-identifies the caller. See packages/client/README.md.

JINTEL_API_KEY wins if both are present.

Quick start

# Either mode works:
export JINTEL_API_KEY=jk_live_your_key_here              # Bearer
# export JINTEL_WALLET_PRIVATE_KEY=0xabc...              # x402 wallet (USDC on Base)

# CLI
npm i -g @yojinhq/jintel-cli
jintel quote AAPL MSFT

# MCP (Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json)
#   "mcpServers": { "jintel": { "command": "npx", "args": ["-y", "@yojinhq/jintel-mcp"],
#                               "env": { "JINTEL_API_KEY": "..." } } }
# Wallet mode: swap "JINTEL_API_KEY" for "JINTEL_WALLET_PRIVATE_KEY" in the env block.

# Claude Code plugin
claude plugin marketplace add YojinHQ/jintel-sdk
claude plugin install jintel@YojinHQ

Local development

pnpm install
pnpm build        # build all packages
pnpm typecheck
pnpm test

Publishing

pnpm publish:client patch   # or minor / major
pnpm publish:cli patch
pnpm publish:mcp patch

Benchmark

benchmark/ is a measurement framework that compares LLM-with-tools configurations on a corpus of financial-research queries. Variants include bare (no tools), anthropic-web-search, jintel-mcp (the published @yojinhq/jintel-mcp), and jintel-cli (the published @yojinhq/jintel-cli over a bash tool).

pnpm bench --model claude-haiku-4-5 --variant all
pnpm bench:report

Latest published results: benchmark/results/. On the 15-question corpus, Haiku-with-jintel-mcp (66.7%) beats Opus-with-web-search (60%) at roughly half the latency, and Opus-with-jintel-mcp leads at 86.7%.

See benchmark/README.md for the full CLI, corpus schema, and grader rules.

License

MIT — see LICENSE.

Links

• API docs: https://api.jintel.ai/docs
• Homepage: https://api.jintel.ai
• Main (private) repo: Jintel API server lives in a separate repo owned by Othentic Labs.