# TrueSource (pypi · truesource-mcp)

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

- Trust score: 74/100 (medium)
- Change this week: +20
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-20

## Components

- pypi · `truesource-mcp`: 74/100 (this document), [markdown](https://verifymcp.io/servers/hangeaiagent-truesource-mcp/truesource-mcp.md), [page](https://verifymcp.io/servers/hangeaiagent-truesource-mcp/truesource-mcp)

## Channel facts

- Registry: `pypi`
- Package: `truesource-mcp`
- Version: `0.1.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-20.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs hatchling.build at install time, a recognised native-build step with no shell scripting around it.
  - 1 of 32 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (Apache-2.0).
  - Actively maintained (last published 9 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 78/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 777 tokens (~129/item across 6 items; 6 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 33/100
  - Stability observed for 10 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 71/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 6 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 6 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the TrueSource MCP server?

TrueSource runs locally as a PyPI package, launched with uvx truesource-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add hangeaiagent-truesource-mcp -- uvx truesource-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "hangeaiagent-truesource-mcp": {
      "command": "uvx",
      "args": [
        "truesource-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "hangeaiagent-truesource-mcp": {
      "command": "uvx",
      "args": [
        "truesource-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add hangeaiagent-truesource-mcp -- uvx truesource-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "hangeaiagent-truesource-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "truesource-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add hangeaiagent-truesource-mcp --command uvx --arg truesource-mcp
```

### Hermes

```yaml
mcp_servers:
  hangeaiagent-truesource-mcp:
    command: "uvx"
    args: ["truesource-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "hangeaiagent-truesource-mcp": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "truesource-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add hangeaiagent-truesource-mcp -t stdio -c uvx -a truesource-mcp
```

### Other

```json
{
  "mcpServers": {
    "hangeaiagent-truesource-mcp": {
      "command": "uvx",
      "args": [
        "truesource-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-20 (score 74, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-09-19 (score 59, +1)

No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-17 (score 58, +4)

- [functional improvement] Stability: unverified → 0.23

### 2026-09-10 (score 54)

First indexed and scored.

## MCP tools (6)

### `truesource_procurement` (~107 tokens)

最近的政府采购中标信号 —— 哪些公司在真拿单。

days   查最近几天,默认 7
limit  最多几条,默认 15

这是 TrueSource 最独有的一块:中标公告是**已经发生的事实**,
比研报的预测更硬。适合回答「谁在实际拿到订单」这类问题。

Input parameters:

- `days` (integer)
- `limit` (integer)

Output parameters:

- `result` (string)

### `truesource_macro` (~69 tokens)

宏观信号 —— 国家统计局 + 海关 + 行业协会的口径数据。

days  查最近几天,默认 30

给的是有明确发布方和日期的原始口径,不是二手解读。

Input parameters:

- `days` (integer)

Output parameters:

- `result` (string)

### `truesource_daily_brief` (~187 tokens)

一批股票的信号摘要 + 预警级别(最近 3 天)。

symbols  逗号分隔的代码,如 `300308,688041`。一次问一批比逐个问快得多。

每只票会带一个 alert_level:
  red    有需要立刻看的负面信号
  yellow 有变化,值得留意
  green  正常
  grey   这几天没采到信号(**不等于没事,是没数据**)

⚠️ grey 和 green 是两件事。grey 表示这只票最近 3 天没有采到任何信号,
可能是它确实安静,也可能是爬虫没覆盖到 —— 别把 grey 读成「安全」。

Input parameters:

- `symbols` (string, required)

Output parameters:

- `result` (string)

### `truesource_alert_signals` (~97 tokens)

只返回达到预警阈值的信号(最近 26 小时)。

symbols  逗号分隔的代码

比 daily_brief 更窄 —— 它只给「需要动作」的那些。
\**空结果是有意义的结论**:这批票最近 26 小时没有触发预警,
不是查询失败。

Input parameters:

- `symbols` (string, required)

Output parameters:

- `result` (string)

### `truesource_report` (~163 tokens)

单只标的的完整研究报告 —— 公告、研发扩张、北向持仓、AI 搜索分类汇总。

symbol  单个股票代码,如 `300308`

\**只有 35 只预制标的(AI 算力链)能秒回。** 其它票会返回 not_found,
那时改用 `truesource_scout` 做实时采集(慢,但任意 A 股都能查)。

这个工具不会自动帮你 fallback 到 scout —— 因为 scout 要跑 30-60 秒
并产生真实花费,那个决定应该由你(或用户)明确做出,不该悄悄发生。

Input parameters:

- `symbol` (string, required)

Output parameters:

- `result` (string)

### `truesource_scout` (~154 tokens)

对一只票做**实时全量采集** —— 任意 A 股都能查。

symbol  股票代码,如 `600519`
name    股票名称(可选,能提高 AI 搜索的命中率)

并行跑价格 + 公告 + 研发扩张 + 北向 + Gemini AI 搜索。

⚠️ **一次要 30-60 秒,且产生真实的第三方 API 花费。**
先试 `truesource_report`(预制标的秒回),它 not_found 了再用这个。
不要在循环里对几十只票调用它。

Input parameters:

- `name` (string)
- `symbol` (string, required)

Output parameters:

- `result` (string)

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/hangeaiagent-truesource-mcp/truesource-mcp#diagnostics

## Score history

- 2026-09-20: 74
- 2026-09-19: 59
- 2026-09-18: 58
- 2026-09-17: 58
- 2026-09-16: 54
- 2026-09-15: 54
- 2026-09-14: 54
- 2026-09-13: 54
- 2026-09-12: 54
- 2026-09-11: 54
- 2026-09-10: 54

## Common questions

### What is the TrueSource MCP server?

TrueSource is an MCP server listed in the public MCP registry as io.github.hangeaiagent/truesource-mcp. First-hand market signals: filings, procurement wins, R&D expansion, macro data. This page covers its PyPI package (truesource-mcp).

### Is the TrueSource MCP server safe to use?

TrueSource scores 74 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the TrueSource MCP server expose?

TrueSource exposes 6 tools: truesource_procurement, truesource_macro, truesource_daily_brief, truesource_alert_signals, truesource_report, truesource_scout. Their descriptions and schemas cost roughly 777 tokens of context every time the server is loaded.

### Is the TrueSource MCP server still maintained?

TrueSource is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the TrueSource MCP server under?

TrueSource declares the Apache-2.0 licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- PyPI project: https://pypi.org/project/truesource-mcp/
- Socket report: https://socket.dev/pypi/package/truesource-mcp
- Repository: https://github.com/agentpit-io/hunter-community
- Changelog RSS feed: https://verifymcp.io/servers/hangeaiagent-truesource-mcp/truesource-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/hangeaiagent-truesource-mcp/truesource-mcp.json
- HTML version of this page: https://verifymcp.io/servers/hangeaiagent-truesource-mcp/truesource-mcp