# Tensient

> Organizational world model for AI agents (MCP) plus Tasks and Feedback REST APIs for server-side integrations.

Tensient is workspace-scoped. Authenticate with a secret API key (`tns_...`) from Settings → Developer. Never embed secret keys in browser or mobile clients.

## Agent index (read this first)

- OpenAPI (REST): https://tensient.com/openapi.json
- MCP quickstart: https://tensient.com/docs/quickstart
- MCP tools reference: https://tensient.com/docs/tools
- Authentication: https://tensient.com/docs/auth

## MCP — context, signals, synthesis, tasks

- Endpoint: https://tensient.com/api/mcp
- Transport: Streamable HTTP, JSON-RPC
- Header: `Authorization: Bearer tns_YOUR_SECRET_KEY`
- Registry: https://tensient.com/mcp-registry/server.json

Use MCP for: signals, brain/canon documents, synthesis, session logs, semantic search, and **task CRUD** via tools (`list_tasks`, `create_task`, etc.).

## REST — customer portals and backends

Secret key only (`tns_...`, not `tns_pub_...`). Optional `actor` on writes attributes your end-user without a Tensient login per user.

### Tasks API

- Docs: https://tensient.com/docs/tasks-api
- Base: https://tensient.com/api/external/tasks
- Categories: https://tensient.com/api/external/task-categories
- Milestones: https://tensient.com/api/external/milestones
- People: https://tensient.com/api/external/people
- Rate limit: 120 requests/minute per API key (default)
- List archived: GET .../api/external/tasks?archived=true

### Feedback

- Ingest (public or secret): POST https://tensient.com/api/feedback/ingest
- Search (secret, for task linking): GET https://tensient.com/api/external/feedback?search=...
- Docs: https://tensient.com/docs/feedback-api
- Public keys (`tns_pub_...`) on ingest only, with origin allowlist

## Auth

- Guide: https://tensient.com/docs/auth
- Bearer: `Authorization: Bearer tns_...`
- Alternative header: `X-API-Key: tns_...`
- Workspace is bound to the key; REST may pass `?workspaceId=` but it must match the key's workspace

## Human documentation

- All docs: https://tensient.com/docs
- Context layer: https://tensient.com/docs/context-layer