TrueSource — Claude Code MCP server: what it does, how to install
Supplies AI agents with factual market signals, government procurement awards, exchange disclosures, and macro releases backed by verifiable sources.
claude mcp add --env HUNTER_API_KEY=<HUNTER_API_KEY> --env TRUESOURCE_URL=<TRUESOURCE_URL> --env TRUESOURCE_MAX_ITEMS=<TRUESOURCE_MAX_ITEMS> --transport stdio truesource-mcp -- uvx truesource-mcpWhat TrueSource does
TrueSource exposes confirmed market occurrences rather than analyst opinions or trading advice. It tracks events that already took place: public procurement wins, corporate filings, research team expansions, and official releases from customs or statistics bureaus. Every record includes its date and source.
The server provides several tools for market analysis. Routine monitoring runs through truesource_daily_brief across a 3-day window, while truesource_alert_signals isolates events exceeding alert thresholds in the past 26 hours. Full research dossiers exist for 35 pre-built AI computing entities. For other A-share tickers, truesource_scout collects live intelligence on demand.
Keyless access is completely blocked. Without HUNTER_API_KEY, the upstream gateway returns a 403 error immediately. Live scouting triggers real web crawlers and Gemini lookups, meaning calls consume third-party API credits. Expect truesource_scout to take 30 to 60 seconds. Responses default to a ceiling of 40 records via TRUESOURCE_MAX_ITEMS.
What it helps with
- retrieve verified government contract awards
- pull official customs and statistics bureau macro releases
- filter ticker alert signals from the past 26 hours
- run live market data collection for A-share companies
Example prompts for the agent
- Check recent government procurement awards using truesource_procurement
- Run truesource_daily_brief for my list of tickers
- Collect live market intelligence on a company using truesource_scout
How to install TrueSource
Platform CLI
claude mcp add --env HUNTER_API_KEY=<HUNTER_API_KEY> --env TRUESOURCE_URL=<TRUESOURCE_URL> --env TRUESOURCE_MAX_ITEMS=<TRUESOURCE_MAX_ITEMS> --transport stdio truesource-mcp -- uvx truesource-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from truesource-mcp <command>
Platform CLI
codex mcp add truesource-mcp --env HUNTER_API_KEY=<HUNTER_API_KEY> --env TRUESOURCE_URL=<TRUESOURCE_URL> --env TRUESOURCE_MAX_ITEMS=<TRUESOURCE_MAX_ITEMS> -- uvx truesource-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from truesource-mcp <command>
Config file
{
"mcpServers": {
"truesource-mcp": {
"command": "uvx",
"args": [
"truesource-mcp"
],
"env": {
"HUNTER_API_KEY": "<HUNTER_API_KEY>",
"TRUESOURCE_URL": "<TRUESOURCE_URL>",
"TRUESOURCE_MAX_ITEMS": "<TRUESOURCE_MAX_ITEMS>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from truesource-mcp <command>
Config file
{
"servers": {
"truesource-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"truesource-mcp"
],
"env": {
"HUNTER_API_KEY": "<HUNTER_API_KEY>",
"TRUESOURCE_URL": "<TRUESOURCE_URL>",
"TRUESOURCE_MAX_ITEMS": "<TRUESOURCE_MAX_ITEMS>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from truesource-mcp <command>
Platform CLI
gemini mcp add -e HUNTER_API_KEY=<HUNTER_API_KEY> -e TRUESOURCE_URL=<TRUESOURCE_URL> -e TRUESOURCE_MAX_ITEMS=<TRUESOURCE_MAX_ITEMS> truesource-mcp uvx truesource-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from truesource-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about TrueSource
How to install TrueSource in Claude Code?
Run claude mcp add truesource-mcp -e HUNTER_API_KEY=<HUNTER_API_KEY> -- uvx truesource-mcp. Replace <HUNTER_API_KEY> with your personal token starting with hunt_tools_.
What does the TrueSource MCP server do?
It feeds verifiable market events directly into coding assistants. The server tracks procurement contracts, corporate exchange filings, and macroeconomic updates.
Why is an API key mandatory for TrueSource?
Calls like truesource_scout execute real-time crawling and Gemini search passes that cost external API credits. The upstream gateway rejects requests without HUNTER_API_KEY.
