Shingou
Hourly crypto news sentiment and typed market events, with sources on every signal.
Open source Repository Open in the app JSON README (API)
About
Hourly crypto news sentiment and typed market events, with sources on every signal.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- io.shingou
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.3.2
- Last push
- 2026-08-02T12:24:11Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:01:46
- Updated
- 2026-09-13 03:12:35
- Origin id
io.shingou/sentiment
README
# Shingou skills [](https://smithery.ai/servers/adol/shingou) [](https://glama.ai/mcp/servers/shingou-io/shingou-skills) Plug the [Shingou](https://shingou.io) point-in-time crypto market sentiment API into Claude or any AI agent. This repo is a skill that teaches the agent to use the API correctly (auth, symbols, quotas, and honest framing of an hourly signal), plus MCP tools for direct access. Works instantly with a **free API key** ([shingou.io/dashboard](https://shingou.io/dashboard), no card). The paid key is what removes the 24h delay outside the live majors, and what buys history depth. | Path | What it is | | --- | --- | | [`plugins/shingou/skills/shingou-api/`](plugins/shingou/skills/shingou-api/) | The skill: SKILL.md + full API reference + worked flows | | MCP endpoint | `https://api.shingou.io/mcp` — the same API as callable tools | | [`src/stdio-proxy.mjs`](src/stdio-proxy.mjs) | Packaged stdio server, for hosts that launch a local process instead of connecting to a remote one | ## Install ### Claude Code (plugin) ``` /plugin marketplace add shingou-io/shingou-skills /plugin install shingou@shingou-skills ``` Then export your key so the agent can use it: ```bash export SHINGOU_API_KEY=sk_live_... ``` ### claude.ai (skill upload) Zip the skill folder (folder at the zip root) and upload it under Settings → Capabilities → Skills: ```bash cd plugins/shingou/skills && zip -r shingou-api.zip shingou-api ``` There are no environment variables on claude.ai — the skill will ask you for the API key in-conversation. ### Any other agent Point your agent at [`plugins/shingou/skills/shingou-api/SKILL.md`](plugins/shingou/skills/shingou-api/SKILL.md) (plain markdown, no Claude-specific machinery), or at the live LLM-oriented reference: [shingou.io/llms-full.txt](https://shingou.io/llms-full.txt). ## MCP Connect the Shingou API as tools (`get_sentiment`, `get_sentiment_history`, `get_events`, `get_symbols`) over Streamable HTTP. **The Claude Code plugin configures this automatically** — with `SHINGOU_API_KEY` exported, the `shingou` MCP server is ready after `/plugin install`. To connect without the plugin: ```bash claude mcp add --transport http shingou https://api.shingou.io/mcp \ --header "x-api-key: sk_live_..." ``` Requests made through MCP are attributed server-side — no User-Agent handling needed. claude.ai remote connectors (OAuth) are planned. ### Packaged server (stdio) Streamable HTTP is the way in, and every client above uses it. Two places cannot: hosts that only launch a local process, and directories that index a server by building it and speaking MCP to its stdin. [`src/stdio-proxy.mjs`](src/stdio-proxy.mjs) bridges both to the same remote endpoint. No dependencies, one HTTP POST per JSON-RPC message. Published to npm, so a host that launches a local process needs no clone: ```bash claude mcp add shingou -- npx -y @shingou-io/mcp-stdio ``` No build step, no `dist/`, no dependencies: the entrypoint is plain JavaScript and runs on Node 18 or newer. It was TypeScript until 0.3.1, which cannot work from an installed package, because Node refuses to strip types for anything under `node_modules` on every version. From a clone or an image instead: ```bash SHINGOU_API_KEY=sk_live_... node src/stdio-proxy.mjs docker build -t shingou-mcp-stdio . docker run -i --rm -e SHINGOU_API_KEY=sk_live_... shingou-mcp-stdio ``` `SHINGOU_MCP_URL` overrides the endpoint. **The key is optional**: `initialize`, `tools/list` and `get_symbols` all answer without one, so a client can discover the tools before the user has a key. The data tools need it. Two layers of checks, split by what a failure would mean: ```bash node --test test/proxy.test.ts # hermetic: stub upstream, no network, no key scripts/smoke.sh # live: builds the image, talks to the real endpoint ``` The first is what CI runs, verbatim and with no package manager, because it fails only when the bridge regresses. `scripts/smoke.sh` runs on a daily schedule instead — it can go red because the API moved or a deploy is mid-flight, and that should not block a pull request. ## Quota math (free tier) 1,000 requests/day, 30/min burst. The signal changes **once per hour per asset**, and one `/v1/sentiment` call batches up to 50 symbols — so even polling the full universe every hour costs 24 requests a day. There is no reason to poll faster. Free history reaches back **one day**, which is enough for `/v1/history/sentiment` to return a real series and not enough to backtest on. Depth is the paid axis: 90 days on `starter`, 365 on `quant`, 730 on `pro`. ## What the signal is (and is not) **Point-in-time first.** Every history bucket carries an as-of timestamp and a `reconstructed` flag, and the bucket's hash is committed to a public append-only log at publish time. So no lookahead is something you can check, not something we ask you to believe. The log is at [shingou-io/shingou-signal-log](https://github.com/shingou-io/shingou-signal-log). The signal itself is one per asset per hour: `score ∈ [-1, 1]`, `confidence ∈ [0, 1]`, a `direction` call, dominant `event` types, and the source articles behind it. Measured performance, including the negative results, is published at [shingou.io/research](https://shingou.io/research). The honest uses are **filter**, **sizing**, and **kill-switch**. Never an entry generator on its own. The skill instructs agents to disclose signal age (free-tier delays) and `reconstructed` history buckets rather than hide them. ## License MIT — see [LICENSE](LICENSE). The skill and MCP tools are free distribution; the subscription is the data. API usage is governed by the [Shingou terms](https://shingou.io/terms) (commercial use included on paid plans; free tier is for personal/evaluation use). *Not investment advice. This is an integration layer for a signal, not trading recommendations; backtest before risking anything.*