Provides read-only access to global event and evidence intelligence including entities, assets, and impact paths.
Also known as bekirdag/tnl-intelligence, intelligence, @theneuralledger/mcp
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Oct 29, 2026
- License
- MIT
What is The Neural Ledger Intelligence MCP?
The Neural Ledger Intelligence provides read-only access to global event and evidence intelligence including entities, assets, and impact paths.
Summary generated from the project's README
About The Neural Ledger Intelligence MCP server
The Neural Ledger Intelligence MCP server provides read-only access to global event and evidence intelligence. It allows users to query data regarding entities, assets, and impact paths through a Model Context Protocol interface. Developers can run this server locally using stdio by providing a TNL_API_KEY or deploy it via streamable HTTP on a specific host and port. When using HTTP mode, clients should provide a bearer token in the Authorization header.
The server includes tools for news searches, event explanations, and deep research via Ledger AI. If a TnlResearchRunner is configured, the server exposes six specialized research tools and a research-workspace resource. Users must possess the tnl:research scope to access these advanced research capabilities. While the system provides market quotes, these are intended for display context rather than serving as an execution-grade price feed.
What you can do with it
- 1Analyze global event intelligenceAsk the AI to find and explain specific global events and their impact paths.
- 2Monitor market contextRetrieve market quotes to provide background information during an analysis.
Written from the project's README. Every use case is checked against a quote from it.
How to install The Neural Ledger Intelligence MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall The Neural Ledger Intelligence MCP in Claude Code
$ claude mcp add --env 'TNL_API_KEY=<YOUR_TNL_API_KEY>' intelligence -- npx -y @theneuralledger/mcpInstall The Neural Ledger Intelligence MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"intelligence": {
"command": "npx",
"args": [
"-y",
"@theneuralledger/mcp"
],
"env": {
"TNL_API_KEY": "<YOUR_TNL_API_KEY>"
}
}
}
}Install The Neural Ledger Intelligence MCP in VS Code
.vscode/mcp.json
{
"servers": {
"intelligence": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@theneuralledger/mcp"
],
"env": {
"TNL_API_KEY": "<YOUR_TNL_API_KEY>"
}
}
}
}Install The Neural Ledger Intelligence MCP in VS Code CLI
$ code --add-mcp '{"name":"intelligence","type":"stdio","command":"npx","args":["-y","@theneuralledger/mcp"],"env":{"TNL_API_KEY":"<YOUR_TNL_API_KEY>"}}'Install The Neural Ledger Intelligence MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"intelligence": {
"command": "npx",
"args": [
"-y",
"@theneuralledger/mcp"
],
"env": {
"TNL_API_KEY": "<YOUR_TNL_API_KEY>"
}
}
}
}Install The Neural Ledger Intelligence MCP in Codex
$ codex mcp add intelligence --env 'TNL_API_KEY=<YOUR_TNL_API_KEY>' -- npx -y @theneuralledger/mcpInstall The Neural Ledger Intelligence MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.intelligence] command = "npx" args = ["-y", "@theneuralledger/mcp"] [mcp_servers.intelligence.env] TNL_API_KEY = "<YOUR_TNL_API_KEY>"
Install The Neural Ledger Intelligence MCP in Gemini CLI
$ gemini mcp add -s user -e 'TNL_API_KEY=<YOUR_TNL_API_KEY>' intelligence npx -- -y @theneuralledger/mcpInstall The Neural Ledger Intelligence MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"intelligence": {
"command": "npx",
"args": [
"-y",
"@theneuralledger/mcp"
],
"env": {
"TNL_API_KEY": "<YOUR_TNL_API_KEY>"
}
}
}
}Configuration
TNL_API_KEYRequiredSecretThe Neural Ledger member API key
TNL_BASE_URLOptional TNL API base URL
| Name | Description | |
|---|---|---|
| TNL_API_KEY | The Neural Ledger member API key | RequiredSecret |
| TNL_BASE_URL | Optional TNL API base URL |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablebekirdag/tnl-intelligence is public and reachablegithub.com/bekirdag/tnl-intelligence ↗Pass
- Package names this repository as its source@theneuralledger/mcp names bekirdag/tnl-intelligence as sourcenpmjs.com/package/@theneuralledger/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-29github.com/bekirdag/tnl-intelligence ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @theneuralledger/mcpPass
- No critical advisory in the package or its dependencies101 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@theneuralledger/mcp
Read-only Model Context Protocol server for The Neural Ledger event and evidence intelligence API.
Stdio
TNL_API_KEY=tnl_... npx -y @theneuralledger/mcp
Streamable HTTP
npx -y @theneuralledger/mcp http
The server binds to 127.0.0.1:7317 by default. Override it with TNL_MCP_HOST and TNL_MCP_PORT. HTTP clients may send their TNL key as Authorization: Bearer ...; it is forwarded only to the TNL API and is never included in tool output.
HTTP mode requires a bearer key even when TNL_API_KEY is present in the server environment. A loopback-only single-user deployment can explicitly restore environment-key fallback with TNL_MCP_ALLOW_ENV_API_KEY=1; do not enable that mode on a shared or remotely reachable server.
The tools expose news search, asset/entity/impact-path intelligence, event explanation, Ledger AI deep research, and service status. TNL provides event and evidence intelligence; its market quotes are display context rather than an execution-grade price feed.
When configured with a TnlResearchRunner, the server also exposes six scoped
tnl_research_* tools plus the ui://tnl/research-workspace MCP App resource.
Without that runner, research tools are not advertised. Hosted callers must hold
the tnl:research scope in addition to base read access.
The Neural Ledger Intelligence MCP questions
How do I add The Neural Ledger Intelligence MCP to Claude Code?
Run claude mcp add --env 'TNL_API_KEY=<YOUR_TNL_API_KEY>' intelligence -- npx -y @theneuralledger/mcp in your terminal. Add --scope user to make it available in every project.
How do I add The Neural Ledger Intelligence MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What kind of intelligence does the server provide?
The server offers news search, asset, entity, and impact-path intelligence, along with event explanations and deep research.
Can I use this server for real-time market trading?
No, the market quotes provided are intended for display context and are not an execution-grade price feed.
How do I enable research tools?
Research tools are only advertised when the server is configured with a TnlResearchRunner.