English Français العربية

The Neural Ledger Intelligence

السجل الرسمي أخرى

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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 (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"
            }
        }
    }
}

متغيرات البيئة

  • TNL_API_KEY إلزامي سري The Neural Ledger member API key
  • TNL_BASE_URL Optional TNL API base URL

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو The Neural Ledger Intelligence؟

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

كيف أثبّت The Neural Ledger Intelligence؟

يعمل على جهازك. في 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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج The Neural Ledger Intelligence إلى مفتاح API؟

نعم. يتطلب TNL_API_KEY، وتضبطها في إعداداته.

هل The Neural Ledger Intelligence مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون The Neural Ledger Intelligence؟

ينشره bekirdag. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.