{
  "markdown": "# Shingou skills\n\n[![smithery badge](https://smithery.ai/badge/adol/shingou)](https://smithery.ai/servers/adol/shingou)\n[![Glama score](https://glama.ai/mcp/servers/shingou-io/shingou-skills/badges/score.svg)](https://glama.ai/mcp/servers/shingou-io/shingou-skills)\n\nPlug the [Shingou](https://shingou.io) point-in-time crypto market sentiment API into Claude or\nany AI agent. This repo is a skill that teaches the agent to use the API correctly (auth,\nsymbols, quotas, and honest framing of an hourly signal), plus MCP tools for direct access.\n\nWorks instantly with a **free API key**\n([shingou.io/dashboard](https://shingou.io/dashboard), no card). The paid key is what removes\nthe 24h delay outside the live majors, and what buys history depth.\n\n| Path | What it is |\n| --- | --- |\n| [`plugins/shingou/skills/shingou-api/`](plugins/shingou/skills/shingou-api/) | The skill: SKILL.md + full API reference + worked flows |\n| MCP endpoint | `https://api.shingou.io/mcp` — the same API as callable tools |\n| [`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 |\n\n## Install\n\n### Claude Code (plugin)\n\n```\n/plugin marketplace add shingou-io/shingou-skills\n/plugin install shingou@shingou-skills\n```\n\nThen export your key so the agent can use it:\n\n```bash\nexport SHINGOU_API_KEY=sk_live_...\n```\n\n### claude.ai (skill upload)\n\nZip the skill folder (folder at the zip root) and upload it under\nSettings → Capabilities → Skills:\n\n```bash\ncd plugins/shingou/skills && zip -r shingou-api.zip shingou-api\n```\n\nThere are no environment variables on claude.ai — the skill will ask you for the API key\nin-conversation.\n\n### Any other agent\n\nPoint your agent at\n[`plugins/shingou/skills/shingou-api/SKILL.md`](plugins/shingou/skills/shingou-api/SKILL.md)\n(plain markdown, no Claude-specific machinery), or at the live LLM-oriented reference:\n[shingou.io/llms-full.txt](https://shingou.io/llms-full.txt).\n\n## MCP\n\nConnect the Shingou API as tools (`get_sentiment`, `get_sentiment_history`, `get_events`,\n`get_symbols`) over Streamable HTTP. **The Claude Code plugin configures this\nautomatically** — with `SHINGOU_API_KEY` exported, the `shingou` MCP server is ready after\n`/plugin install`. To connect without the plugin:\n\n```bash\nclaude mcp add --transport http shingou https://api.shingou.io/mcp \\\n  --header \"x-api-key: sk_live_...\"\n```\n\nRequests made through MCP are attributed server-side — no User-Agent handling needed.\nclaude.ai remote connectors (OAuth) are planned.\n\n### Packaged server (stdio)\n\nStreamable HTTP is the way in, and every client above uses it. Two places cannot: hosts that\nonly launch a local process, and directories that index a server by building it and speaking\nMCP to its stdin. [`src/stdio-proxy.mjs`](src/stdio-proxy.mjs) bridges both to the same remote\nendpoint. No dependencies, one HTTP POST per JSON-RPC message.\n\nPublished to npm, so a host that launches a local process needs no clone:\n\n```bash\nclaude mcp add shingou -- npx -y @shingou-io/mcp-stdio\n```\n\nNo build step, no `dist/`, no dependencies: the entrypoint is plain JavaScript and runs on\nNode 18 or newer. It was TypeScript until 0.3.1, which cannot work from an installed package,\nbecause Node refuses to strip types for anything under `node_modules` on every version.\n\nFrom a clone or an image instead:\n\n```bash\nSHINGOU_API_KEY=sk_live_... node src/stdio-proxy.mjs\n\ndocker build -t shingou-mcp-stdio .\ndocker run -i --rm -e SHINGOU_API_KEY=sk_live_... shingou-mcp-stdio\n```\n\n`SHINGOU_MCP_URL` overrides the endpoint. **The key is optional**: `initialize`, `tools/list`\nand `get_symbols` all answer without one, so a client can discover the tools before the user\nhas a key. The data tools need it.\n\nTwo layers of checks, split by what a failure would mean:\n\n```bash\nnode --test test/proxy.test.ts   # hermetic: stub upstream, no network, no key\nscripts/smoke.sh                 # live: builds the image, talks to the real endpoint\n```\n\nThe first is what CI runs, verbatim and with no package manager, because it fails only when\nthe bridge regresses.\n`scripts/smoke.sh` runs on a daily schedule instead — it can go red because the API moved\nor a deploy is mid-flight, and that should not block a pull request.\n\n## Quota math (free tier)\n\n1,000 requests/day, 30/min burst. The signal changes **once per hour per asset**, and one\n`/v1/sentiment` call batches up to 50 symbols — so even polling the full universe every hour\ncosts 24 requests a day. There is no reason to poll faster.\n\nFree history reaches back **one day**, which is enough for `/v1/history/sentiment` to return a\nreal series and not enough to backtest on. Depth is the paid axis: 90 days on `starter`, 365 on\n`quant`, 730 on `pro`.\n\n## What the signal is (and is not)\n\n**Point-in-time first.** Every history bucket carries an as-of timestamp and a `reconstructed`\nflag, and the bucket's hash is committed to a public append-only log at publish time. So no\nlookahead is something you can check, not something we ask you to believe. The log is at\n[shingou-io/shingou-signal-log](https://github.com/shingou-io/shingou-signal-log).\n\nThe signal itself is one per asset per hour: `score ∈ [-1, 1]`, `confidence ∈ [0, 1]`, a\n`direction` call, dominant `event` types, and the source articles behind it. Measured\nperformance, including the negative results, is published at\n[shingou.io/research](https://shingou.io/research). The honest uses are **filter**, **sizing**,\nand **kill-switch**. Never an entry generator on its own. The skill instructs agents to disclose\nsignal age (free-tier delays) and `reconstructed` history buckets rather than hide them.\n\n## License\n\nMIT — see [LICENSE](LICENSE). The skill and MCP tools are free distribution; the subscription\nis the data. API usage is governed by the [Shingou terms](https://shingou.io/terms)\n(commercial use included on paid plans; free tier is for personal/evaluation use).\n\n*Not investment advice. This is an integration layer for a signal, not trading\nrecommendations; backtest before risking anything.*\n",
  "bytes": 6095,
  "sha": "1db115c99e38dbb08dba3d16ae0ea5285ab7794d0842e50e6ef8224e9a1b8a41",
  "repo_slug": "shingou-io/shingou-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_shingou_sentiment_16781c26/readme"
}