npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@haruspex-guru/mcp-server-gemini

v1.1.0

Published

Haruspex MCP server tuned for Gemini CLI. Exposes the Haruspex public API (live multi-dimension stock scoring) as MCP tools — get_stock_score, get_batch_scores, get_stock_score_history, search_stocks, get_stock_news. Spawned by the Haruspex Gemini CLI ext

Downloads

285

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

haruspex-guruharuspex-guru

Keywords

mcpmodel-context-protocolharuspexstocksfinancegeminigemini-cligoogle-gemini

Readme

@haruspex-guru/mcp-server-gemini

npm version License: MIT

Live multi-dimension stock scoring for Gemini CLI. MCP server that exposes the Haruspex API (0–100 composite scores, outlook, signal, 26 specialized AI dimensions) as tools for Gemini's chat agent.

Spawned automatically by the Haruspex Gemini CLI extension.

Sister package for non-Gemini hosts (Claude Desktop, Claude Code, Cursor, Windsurf, Base44): @haruspex-guru/mcp-server.

What you get

You: gemini "what's the score for NVDA?"

Gemini: NVDA — Haruspex Score: 72/100 (cautiously bullish)
        Signal: BUY  |  Change: +3 (vs. yesterday)

        Top dimensions:
          AI Exposure       89/100  (+2)
          Competitors       78/100  (=)
          Fundamentals      71/100  (+1)
          Insider Activity  62/100  (-4)

        https://haruspex.guru/s/NVDA

Tools

| Tool | What it does | Credits | |------|--------------|--------:| | get_stock_score | Latest score (0–100), outlook, signal, dimension breakdown, share URL | 1 | | get_stock_score_history | Daily scores over a date range | 2 | | get_batch_scores | Up to 50 tickers in one call | 1/symbol | | search_stocks | Find tickers by symbol or company name | 1 | | get_stock_news | Recent articles driving score changes | 1 | | record_skill_invocation | Anonymous telemetry ping (tagged client: "gemini-cli") | 0 |

Quickstart

Install via the Gemini extension (recommended)

gemini extensions install https://github.com/Haruspex-guru/haruspex-gemini-extension

Gemini will prompt for your HARUSPEX_API_KEY. Get one at haruspex.guru/haruspex-api. Free tier = 100 credits/month.

Or wire MCP manually

{
  "mcpServers": {
    "haruspex": {
      "command": "npx",
      "args": ["-y", "@haruspex-guru/mcp-server-gemini@^1.1.0"],
      "env": {
        "HARUSPEX_API_KEY": "hrspx_your_key"
      }
    }
  }
}

Example prompts

gemini "what's the Haruspex score for TSLA?"
gemini "compare AAPL, MSFT, and GOOGL on Haruspex fundamentals"
gemini "find 5 AI-exposure stocks scoring above 70"
gemini "is NVDA's score trending up or down this month?"

Privacy

Outbound HTTPS calls only to https://haruspex.guru/api/v1. No prompts, no chat content, no PII. Set HARUSPEX_TELEMETRY=0 to disable the skill-invocation ping.

Environment variables

| Variable | Default | Purpose | |----------|---------|---------| | HARUSPEX_API_KEY | (required) | Your hrspx_... API key | | HARUSPEX_TELEMETRY | 1 | Set 0 to disable the skill-invocation ping |

The Gemini package hardcodes client: "gemini-cli" for telemetry attribution; no override needed.

License

MIT. The MCP server is open source. The Haruspex scoring algorithm and underlying data are proprietary; access governed by the Haruspex API Terms of Service.

Links