English Français العربية

The Neural Ledger Intelligence

Official registry Other

Read-only global event and evidence intelligence with entities, assets, and impact paths.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @theneuralledger/mcp
Claude Code 
claude mcp add the-neural-ledger-intelligence -e 'TNL_API_KEY=<your tnl_api_key>' -e 'TNL_BASE_URL=https://theneuralledger.com' -- npx -y @theneuralledger/mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "the-neural-ledger-intelligence": {
            "command": "npx",
            "args": [
                "-y",
                "@theneuralledger/mcp@0.1.0"
            ],
            "env": {
                "TNL_API_KEY": "<your tnl_api_key>",
                "TNL_BASE_URL": "https://theneuralledger.com"
            }
        }
    }
}

Environment variables

  • TNL_API_KEY required secret The Neural Ledger member API key
  • TNL_BASE_URL Optional TNL API base URL

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. TNL Intelligence
  2. Packages
  3. Quick Start
  4. Security
  5. Development
  6. Documentation
  7. License

TNL Intelligence

Open-source developer tools for The Neural Ledger intelligence API.

TNL Intelligence gives AI agents and quantitative research systems structured, source-linked global event intelligence. It is an evidence and research layer, not a broker, an order router, or a source of trading-grade prices.

Packages

PackagePurpose
@theneuralledger/sdkTyped TypeScript client for the TNL /v1 API
@theneuralledger/mcpRead-only MCP server over stdio or Streamable HTTP
@theneuralledger/gatewayHosted OAuth, tenant policy, quota, and audit MCP gateway
@theneuralledger/onboardingDeveloper credentials, static sample API, and explorer
@theneuralledger/eventsWebhook contracts, signed delivery, and verification helpers
@theneuralledger/researchEvidence-first skills, orchestration, MCP App, and web UI
@theneuralledger/adaptersShared Cursor and OpenAI workflow contracts and rendering
@theneuralledger/connectorsShared n8n, Pipedream, and Zapier action/trigger contracts
@theneuralledger/clitnl CLI, watch command, local cache, and foreground daemon
tnl-intelligencePython SDK and optional point-in-time quant research toolkit

Quick Start

Set a member API key in the environment:

export TNL_API_KEY="..."

Run the MCP server over stdio:

npx -y @theneuralledger/mcp

Or run its localhost Streamable HTTP endpoint:

docker compose up --build
curl http://127.0.0.1:7317/healthz

Use the CLI:

npx -y @theneuralledger/cli latest
npx -y @theneuralledger/cli search "Federal Reserve"

Use the TypeScript SDK:

import { TnlClient } from '@theneuralledger/sdk';

const client = new TnlClient({ apiKey: process.env.TNL_API_KEY! });
const page = await client.listNews({ sort: 'pipeline', pageSize: 20 });

Use the Python SDK:

from tnl_intelligence import TnlClient

with TnlClient(api_key="...") as client:
    page = client.list_news(sort="pipeline", page_size=20)

Security

  • API keys are never accepted as visible command-line arguments.
  • MCP tools are read-only and do not place trades.
  • Streamable HTTP binds to 127.0.0.1 by default.
  • Local daemon events never contain the API key.
  • Hosted deployments use the separate gateway, TLS ingress, OAuth validation, tenant policy, short-lived upstream capabilities, and distributed quotas.

See SECURITY.md and the build plan. Research deployment boundaries and staged rollout are documented in Research operations.

Development

npm install
npm run openapi:sync
npm run validate

Python development uses the project under python/tnl_intelligence.

Documentation

License

MIT

Frequently asked questions

What is The Neural Ledger Intelligence?

Read-only global event and evidence intelligence with entities, assets, and impact paths.

How do I install The Neural Ledger Intelligence?

It runs on your machine. In Claude Code: claude mcp add the-neural-ledger-intelligence -e 'TNL_API_KEY=<your tnl_api_key>' -e 'TNL_BASE_URL=https://theneuralledger.com' -- npx -y @theneuralledger/mcp@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does The Neural Ledger Intelligence need an API key?

Yes. It expects TNL_API_KEY, which you set in its configuration.

Is The Neural Ledger Intelligence open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains The Neural Ledger Intelligence?

It is published by bekirdag. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.