{
  "markdown": "# TNL Intelligence\n\nOpen-source developer tools for [The Neural Ledger](https://theneuralledger.com) intelligence API.\n\nTNL 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.\n\n## Packages\n\n| Package                       | Purpose                                                      |\n| ----------------------------- | ------------------------------------------------------------ |\n| `@theneuralledger/sdk`        | Typed TypeScript client for the TNL `/v1` API                |\n| `@theneuralledger/mcp`        | Read-only MCP server over stdio or Streamable HTTP           |\n| `@theneuralledger/gateway`    | Hosted OAuth, tenant policy, quota, and audit MCP gateway    |\n| `@theneuralledger/onboarding` | Developer credentials, static sample API, and explorer       |\n| `@theneuralledger/events`     | Webhook contracts, signed delivery, and verification helpers |\n| `@theneuralledger/research`   | Evidence-first skills, orchestration, MCP App, and web UI    |\n| `@theneuralledger/adapters`   | Shared Cursor and OpenAI workflow contracts and rendering    |\n| `@theneuralledger/connectors` | Shared n8n, Pipedream, and Zapier action/trigger contracts   |\n| `@theneuralledger/cli`        | `tnl` CLI, watch command, local cache, and foreground daemon |\n| `tnl-intelligence`            | Python SDK and optional point-in-time quant research toolkit |\n\n## Quick Start\n\nSet a member API key in the environment:\n\n```bash\nexport TNL_API_KEY=\"...\"\n```\n\nRun the MCP server over stdio:\n\n```bash\nnpx -y @theneuralledger/mcp\n```\n\nOr run its localhost Streamable HTTP endpoint:\n\n```bash\ndocker compose up --build\ncurl http://127.0.0.1:7317/healthz\n```\n\nUse the CLI:\n\n```bash\nnpx -y @theneuralledger/cli latest\nnpx -y @theneuralledger/cli search \"Federal Reserve\"\n```\n\nUse the TypeScript SDK:\n\n```ts\nimport { TnlClient } from '@theneuralledger/sdk';\n\nconst client = new TnlClient({ apiKey: process.env.TNL_API_KEY! });\nconst page = await client.listNews({ sort: 'pipeline', pageSize: 20 });\n```\n\nUse the Python SDK:\n\n```python\nfrom tnl_intelligence import TnlClient\n\nwith TnlClient(api_key=\"...\") as client:\n    page = client.list_news(sort=\"pipeline\", page_size=20)\n```\n\n## Security\n\n- API keys are never accepted as visible command-line arguments.\n- MCP tools are read-only and do not place trades.\n- Streamable HTTP binds to `127.0.0.1` by default.\n- Local daemon events never contain the API key.\n- Hosted deployments use the separate gateway, TLS ingress, OAuth validation,\n  tenant policy, short-lived upstream capabilities, and distributed quotas.\n\nSee [SECURITY.md](SECURITY.md) and the [build plan](docs/planning/tnl-intelligence-build-plan.md).\nResearch deployment boundaries and staged rollout are documented in\n[Research operations](docs/research-operations.md).\n\n## Development\n\n```bash\nnpm install\nnpm run openapi:sync\nnpm run validate\n```\n\nPython development uses the project under `python/tnl_intelligence`.\n\n## Documentation\n\n- [Architecture](docs/architecture.md)\n- [Configuration and credential handling](docs/configuration.md)\n- [Hosted gateway operations](docs/gateway-operations.md)\n- [Developer onboarding](docs/developer/index.md)\n- [Webhook operations](docs/webhook-operations.md)\n- [Foreground daemon operations](docs/daemon.md)\n- [Publication runbook](docs/publishing.md)\n- [Distribution and product expansion strategy](docs/distribution-and-product-expansion.md)\n- [AI client adapters](docs/ai-client-adapters.md)\n- [Automation connectors](docs/automation-connectors.md)\n- [Quantitative research toolkit](docs/quant-research-toolkit.md)\n- [Implementation plan](docs/planning/tnl-intelligence-build-plan.md)\n- [Distribution tools build plan](docs/planning/tnl-distribution-tools-build-plan.md)\n\n## License\n\nMIT\n",
  "bytes": 3900,
  "sha": "01e69af592b26fc5d022ab2fea74de8294cadbddd4e7136aabd574af08c85e88",
  "repo_slug": "bekirdag/tnl-intelligence",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_theneuralledger_intelligence_0a469d5b/readme"
}