# Losi — connect AI agents to workspace context

Losi gives LLMs and MCP clients access to live workspace data: Spaces (tasks,
notes, calendar), Nexus CRM, knowledge graph, skills, soul, and memories.

## Start here

- Context Bank (SDK + MCP + REST + OAuth): https://losi.ai/docs/context-bank
- API Access (chat completions, keys, scopes): https://losi.ai/docs/api-access
- Documentation index: https://losi.ai/docs

## Hosted MCP

- URL: https://losi.ai/api/mcp
- Transport: Streamable HTTP (JSON-RPC)
- Auth: OAuth (preferred for interactive hosts) OR Authorization: Bearer + API key

## OAuth discovery

- Authorization server: https://losi.ai/.well-known/oauth-authorization-server
- Protected resource (MCP): https://losi.ai/.well-known/oauth-protected-resource
- Register client: POST https://losi.ai/api/oauth/register
- Authorize: GET https://losi.ai/api/oauth/authorize
- Token: POST https://losi.ai/api/oauth/token
- User consent UI: https://losi.ai/oauth/authorize

## Context Bank REST

- Base: https://losi.ai/api/v1/context-bank
- Verify: GET /session (Bearer token or OAuth access_token)
- Search: GET /search?q= (alias: query=)

## API keys (non-interactive)

Create workspace-scoped keys at https://losi.ai/?settings=profile&tab=api
Store as LOSI_API_KEY — never paste keys into chat prompts.

## Agent skills (optional)

npx skills add losi-ai/context-bank --all

## ACP coding agent (Xcode / Zed)

- Docs: https://github.com/losi-ai/context-bank (package @losi-ai/acp) / repo packages/losi-acp
- Chat: streaming POST https://losi.ai/api/v1/chat/completions
- Auth: workspace API key LOSI_API_KEY (not MCP OAuth)

Open source: https://github.com/losi-ai/context-bank
npm: https://www.npmjs.com/org/losi-ai