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

Related MCP server: alphai-news

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

• Architecture

• Configuration and credential handling

• Hosted gateway operations

• Developer onboarding

• Webhook operations

• Foreground daemon operations

• Publication runbook

• Distribution and product expansion strategy

• AI client adapters

• Automation connectors

• Quantitative research toolkit

• Implementation plan

• Distribution tools build plan

License

MIT