{
  "markdown": "# praesentire-mcp\n\nMCP server for [Praesentire](https://praesentire.com) — **bilingual financial news sentiment as a Claude tool**.\n\n## What Claude gets\n\nThree tools, one API:\n\n| Tool | What it does |\n|---|---|\n| **`get_sentiment`** | Aggregated -1 to +1 sentiment score + confidence + bull/bear distribution + latest 3 articles with rationale, for one ticker. |\n| **`get_sentiment_batch`** | Same aggregates for up to 50 tickers in one call. Each ticker bills as one request. |\n| **`compare_languages`** | English vs Traditional Chinese sentiment side-by-side + divergence score. Designed for cross-market arbitrage signals. |\n\nSources: Reuters, Bloomberg, Yahoo Finance, CNBC (English) + 經濟日報, 工商時報, Anue 鉅亨 (繁中). Updated every 10 minutes.\n\n## Install\n\nYou need a Praesentire API key. [Sign up free](https://praesentire.com/signup) — 100 req/day forever, no credit card.\n\n### Claude Code\n\nAdd to `.mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"praesentire\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"praesentire-mcp\"],\n      \"env\": {\n        \"PRAESENTIRE_API_KEY\": \"pr_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nThen `claude` and ask: *\"What's the sentiment on NVDA?\"*\n\n### Claude Desktop / Cowork\n\nEdit your Claude Desktop config (`%APPDATA%\\Claude\\claude_desktop_config.json` on Windows, `~/Library/Application Support/Claude/claude_desktop_config.json` on Mac):\n\n```json\n{\n  \"mcpServers\": {\n    \"praesentire\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"praesentire-mcp\"],\n      \"env\": {\n        \"PRAESENTIRE_API_KEY\": \"pr_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The three tools will appear in the connectors list.\n\n### Local test\n\n```bash\nPRAESENTIRE_API_KEY=pr_your_key npx praesentire-mcp\n# Server starts on stdio. Press Ctrl+C to stop.\n```\n\n## Example prompts\n\nOnce installed, Claude can answer things like:\n\n> **\"What's the news sentiment on NVDA right now?\"**\n> → Calls `get_sentiment(\"NVDA\")`, returns aggregated score + the 3 articles driving it.\n\n> **\"Compare English vs Chinese sentiment on TSMC — is there divergence?\"**\n> → Calls `compare_languages(\"TSM\")`, returns side-by-side plus divergence score. If `|divergence| > 0.3`, that's a notable cross-market signal.\n\n> **\"Sentiment on my watchlist: NVDA, AMD, AVGO, TSM, ASML, INTC, MU.\"**\n> → Calls `get_sentiment_batch([\"NVDA\",\"AMD\",...])`, returns all at once.\n\n> **\"Why is NVDA down today? Pull sentiment + latest articles.\"**\n> → Calls `get_sentiment(\"NVDA\")` and Claude summarises the rationales.\n\n## Pricing\n\nPraesentire's pricing (the API behind this MCP):\n\n| Tier | Requests / day | Price |\n|---|---|---|\n| Free | 100 | $0 forever |\n| Hobby | 1,000 | $19 / mo |\n| Pro | 10,000 | $99 / mo |\n| Business | 100,000 | $499 / mo |\n\nEach tool call = 1 request. `get_sentiment_batch` with N tickers = N requests.\n\n## Configuration\n\nEnv vars:\n\n| Var | Default | Description |\n|---|---|---|\n| `PRAESENTIRE_API_KEY` | (required) | Your API key (`pr_...`). Get one at https://praesentire.com/dashboard. |\n| `PRAESENTIRE_BASE_URL` | `https://praesentire.com/api/v1` | Override if self-hosting / testing against staging. |\n\n## Error handling\n\nThe MCP server maps Praesentire's HTTP errors to LLM-friendly messages:\n\n- **401** → \"API key invalid or revoked. Create a new one at praesentire.com/dashboard.\"\n- **429** → \"Daily limit reached for tier X. Upgrade at praesentire.com/pricing or wait for reset.\"\n- **400** → Specific validation error (invalid ticker, bad params).\n- **5xx** → \"Praesentire API error N. Try again.\"\n\n## Links\n\n- 🏠 [praesentire.com](https://praesentire.com)\n- 📖 [API docs](https://praesentire.com/docs)\n- 🔑 [Dashboard](https://praesentire.com/dashboard)\n- 🐛 [Issues](https://github.com/Etha0916/praesentire-mcp/issues)\n\n## License\n\nMIT\n",
  "bytes": 3775,
  "sha": "95579e84dcafca9540a60a449096ffba86419986524bf8a931ce33e8e9f5ff17",
  "repo_slug": "etha0916/praesentire-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_etha0916_praesentire_mcp_d48c426e/readme"
}