Back to Browse

Tnl Intelligence MCP Server

FinanceLow Risk9.7MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

9.7
Low Risk9.7Low Risk

Valid MCP server (5 strong, 2 medium validity signals). No known CVEs in dependencies. ⚠️ Package registry links to a different repository than scanned source. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

17 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

The Neural Ledger member API keyRequired

Environment variable: TNL_API_KEY

Optional TNL API base URLOptional

Environment variable: TNL_BASE_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "com-theneuralledger-intelligence": {
      "env": {
        "TNL_API_KEY": "your-tnl-api-key-here",
        "TNL_BASE_URL": "your-tnl-base-url-here"
      },
      "args": [
        "-y",
        "@theneuralledger/mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

Reviews

No reviews yet

Be the first to review this server!