TrueSource

io.github.hangeaiagentPublished by GitHub account hangeaiagentv0.1.1Updated Oct 28, 2026

First-hand market signals: filings, procurement wins, R&D expansion, macro data

The publisher's own server: Source

VerifiedSTDIODesktop onlyWeb Search & ScrapingFinanceData & Analytics

Overview

AI-generated overview

MCP server that gives an assistant citable first-hand market signals: filings, government procurement awards, R&D moves and macro releases, plus per-ticker…

What you can do
  • Retrieve recent government procurement awards and macro releases from statistics, customs and industry bodies
  • Get a signal digest with alert levels for a batch of tickers, or only signals that crossed an alert threshold
  • Fetch a full research report for one of 35 pre-built AI-compute names
  • Run a live full collection for any A-share ticker, which takes 30-60 seconds
  • Every signal carries a date and its source, and truncated responses are flagged with the real total
When to use it
Useful when an assistant needs factual, source-backed market events rather than analyst summaries or buy/sell calls, for example tracking who wins public contracts, checking macro releases, or screening A-share tickers for recent signals.
Requirements
Runs locally over stdio, typically via uvx or pip install of the truesource-mcp package. Requires a HUNTER_API_KEY from the provider's developer page; there is no keyless mode. Optional settings include TRUESOURCE_MAX_ITEMS, TRUESOURCE_URL for self-hosting, and timeout and transport variables. Network access to the upstream gateway is needed.
Before you install
Each scout call runs real crawlers and a third-party search, so invocations spend money on external APIs; the key is required for that reason. The API key is shown once and must be kept secret. A grey alert level means no signal was collected, not that the stock is safe, and empty results are conclusions rather than failures. Report does not fall back to scout automatically.

Installation

In SourceWeft

  1. Open TrueSource in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

truesource-mcp

First-hand market signals your AI agent can actually cite.

An MCP server wrapping TrueSource — a crawler and AI-retrieval stack that watches things which have already happened and carry a verifiable source: exchange filings, government procurement awards, R&D expansion moves, northbound holdings, and official macro releases.

It does not summarise analyst reports and it does not emit buy/sell calls. Every signal comes with a date and where it came from.

[License]

Tools

ToolWhat it doesSpeed
truesource_procurement(days, limit)Recent government procurement awards — who is actually winning contractsfast
truesource_macro(days)Macro releases from the statistics bureau, customs and industry bodiesfast
truesource_daily_brief(symbols)Signal digest + alert level for a batch of tickers (last 3 days)fast
truesource_alert_signals(symbols)Only signals that crossed an alert threshold (last 26 hours)fast
truesource_report(symbol)Full research report — 35 pre-built AI-compute names onlyfast
truesource_scout(symbol, name)Live full collection for any A-share30–60s

Procurement is the most distinctive one: a contract award is a fact that has already occurred, which is a harder input than a forecast.

Quick start

You need an API key first — see below.

Claude Desktop / Cursor

Add to claude_desktop_config.json:

json
{  "mcpServers": {    "truesource": {      "command": "uvx",      "args": ["truesource-mcp"],      "env": { "HUNTER_API_KEY": "hunt_tools_xxx" }    }  }}

Command line

bash
# no install neededHUNTER_API_KEY=hunt_tools_xxx uvx truesource-mcp
# or install itpip install truesource-mcpHUNTER_API_KEY=hunt_tools_xxx truesource-mcp

API key

This server has no keyless mode, and cannot have one — the upstream gateway returns 403 without a key.

The reason is cost: truesource_scout runs real crawlers plus a Gemini search on every call, so each invocation spends money on third-party APIs. Anonymous access would be trivially expensive to abuse and impossible to attribute.

Get one at https://hunter.agentpit.io/dev/api-keys — sign in, click 申请 API Key, copy the hunt_tools_… key (shown once), set it as HUNTER_API_KEY.

If the key is missing, this server does not return sample data or a fake success. It returns an error that tells you exactly where to get a key.

Environment variables

VariableDefaultNotes
HUNTER_API_KEY—Required. hunt_tools_ key
TRUESOURCE_URLhttps://hunter.agentpit.io/api/saas/truesourcePoint at your own deployment if you self-host
TRUESOURCE_TIMEOUT20Seconds. scout gets its own 120s floor regardless
TRUESOURCE_MAX_ITEMS40Cap on items per response
TRUESOURCE_MCP_TRANSPORTstdiostdio | streamable-http | sse
TRUESOURCE_MCP_HOST / _PORT0.0.0.0 / 8933Remote transports only

stdio is what Claude Desktop, Cursor and uvx use. Run a remote transport only if one long-running server should serve several clients — and prefer streamable-http, since the MCP spec marks SSE as deprecated.

Three things that will bite you otherwise

grey is not green. In daily_brief, an alert level of grey means no signal was collected for this ticker in the last 3 days. That may mean the stock was quiet, or it may mean coverage missed it. It does not mean "safe".

An empty result is a conclusion, not a failure. alert_signals returning nothing means these tickers crossed no threshold in the last 26 hours. That is information. This server never dresses an empty result up as an error, and never fills it with placeholder rows.

Truncation is always disclosed. Responses are capped at TRUESOURCE_MAX_ITEMS (40 by default). When that bites, the payload carries truncated: true, the real total, and a note not to draw conclusions from the visible slice. Raise the cap or narrow the date range instead.

truesource_report also will not silently fall back to scout when a ticker isn't one of the 35 pre-built names. Scout costs 30–60 seconds and real money — that choice should be made deliberately, not happen behind your back.

Errors you might hit

ErrorMeaning
missing_api_keyHUNTER_API_KEY not set — see API key
invalid_api_key (401)Key wrong, incomplete or revoked
forbidden (403)Key valid but lacks access to this endpoint
not_found (404)For report: ticker isn't a pre-built name — use truesource_scout
timeoutscout genuinely takes 30–60s; raise TRUESOURCE_TIMEOUT
upstream_down (502/503)Crawler service is down; retry later

Related

  • kronos-mcp — K-line forecasting for A-shares, US and HK equities
  • akshare-mcp — lets a model explore AKShare's 1000+ China market data functions on its own
  • hunter-community — the open-source stack these come from

Apache-2.0.

Source: tools/truesource-mcp/README.md at commit 4af6d96

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Source integrations

Source

app.sourceOfficial publisher

Remote MCP endpoint from Source that gives an assistant access to marketing attribution and analytics for websites connected to Source.

Streamable HTTPWeb executableAuth
Data & AnalyticsCredential requiredNov 5, 2026

ArxSource

Published by GitHub account nicolaiprodromov

Local MCP server that lets an assistant search arXiv, read papers section by section or in LaTeX, follow citations, and find a paper's code.

STDIODesktop only
Developer ToolsNot validated yetNov 7, 2026

SourceMed

io.sourcemed

SourceMed gives an assistant a source-verified clinical evidence library: ask evidence questions, browse shelves, and read cited cards.

STDIODesktop only
AI & ML4 toolsNov 6, 2026

Spree Commerce: open-source B2B and marketplace ecommerce

Published by GitHub account spree

Spree's MCP server lets an AI assistant merchandise a Spree store's catalog, answer reporting questions and manage store setup in plain language.

Streamable HTTPWeb executable
Business & CommerceNot indexed yetNov 6, 2026

PlushSource

Published by GitHub account quickman924

Local MCP server over a bundled directory of custom plush manufacturers, letting an assistant search, filter, compare and cite listings.

STDIODesktop only
Business & Commerce5 toolsNov 3, 2026