# Tanso Developer Resources

Tanso is self-hosted (AGPL-3.0). There is no hosted API at tansohq.com —
every endpoint below lives on your own instance (`YOUR-INSTANCE`).

## APIs

- Client REST API: https://YOUR-INSTANCE/api/v1/client/
- MCP Server: https://YOUR-INSTANCE/mcp (off by default; operator enables it)

## Authentication

- API key via `Authorization: Bearer sk_live_*` or `X-API-Key` header
- Keys are generated in your instance's dashboard (Settings > API Keys)
- Full guide: https://tansohq.com/docs/agent-auth.md

## MCP Server

```json
{
  "mcpServers": {
    "tanso": {
      "type": "url",
      "url": "https://YOUR-INSTANCE/mcp",
      "headers": { "X-API-Key": "<YOUR_API_KEY>" }
    }
  }
}
```

Tool catalog: https://tansohq.com/api/llms.txt and https://tanso.mintlify.app/mcp

## Getting started

    git clone https://github.com/tansohq/tanso-oss.git
    cd tanso-oss/deploy
    cp .env.example .env     # set JWT_SECRET
    docker compose up -d --build
    ./setup.sh               # seeds a test account, prints credentials

Full walkthrough: https://tanso.mintlify.app/quickstart

## SDKs

- TypeScript SDK: https://www.npmjs.com/package/@tansohq/sdk

## Discovery Files

- llms.txt: https://tansohq.com/llms.txt
- AGENTS.md: https://tansohq.com/AGENTS.md
- agents.json: https://tansohq.com/agents.json
- MCP discovery: https://tansohq.com/.well-known/mcp.json
- Skills index: https://tansohq.com/.well-known/skills.json
- API catalog: https://tansohq.com/.well-known/api-catalog

## Docs & Source

- Documentation: https://tanso.mintlify.app
- Source (AGPL-3.0): https://github.com/tansohq/tanso-oss