---
title: "Tanso agent guide"
canonical: https://tansohq.com/docs/agent-auth.md
description: "Make your product work for customers' AI agents across web, onboarding, and monetization. Try the demo, request an evaluation, or explore tanso-oss."
---

# Tanso agent guide

This guide distinguishes the public marketing site from a self-hosted tanso-oss instance.

## Read this website

Public product information needs no account. Use explicit .md links or request Accept: text/markdown. JSON site information is at https://tansohq.com/api/agent.

The demo is authored sample data. Evaluations for your own product are by request. tansohq.com does not offer a hosted billing API, billing MCP server, OAuth server, product signup, or automated product evaluation. Agent signup exists in the open-source engine and runs on each self-hosted instance; see the section below.

## Request an evaluation with permission

POST https://tansohq.com/api/evaluation-request accepts a contact request. Required JSON fields are requestId (UUID) and email (valid email). Optional fields: productUrl (http or https website, or a plain domain), task (up to 2,000 characters), and source (up to 80 letters, digits, underscores, or hyphens). Use source agent_evaluation.

Submit only with the person's permission. This does not create an account or authorize a purchase.

Success is HTTP 200 with {"success":true,"requestId":"..."}. Treat the request as received only after that response. Retry a timeout with the same requestId and identical payload. HTTP 400 means invalid input; 405 means unsupported method; 5xx means delivery was not confirmed. Keep the person's information available for retry. Email fallback: kat@tansohq.com.

## Integrate a self-hosted instance

Obtain the instance URL and appropriately scoped credentials from its operator. Follow the [deployment documentation](https://tanso.mintlify.app) and [repository instructions](https://github.com/tansohq/tanso-oss). Never send instance credentials to tansohq.com.

## Sign up an agent on a self-hosted instance

The engine, [tanso-oss](https://github.com/tansohq/tanso-oss), ships an opt-in agent signup endpoint. When the operator enables the public catalog for an account, POST {instance}/public/v1/catalog/{slug}/signup creates a customer on the free plan and returns a customer-scoped API key (ck_...) with read and purchase scopes in one call. No CAPTCHA and no email loop; the customer starts provisional and a completed Stripe payment claims it. Each instance serves the step-by-step runbook at {instance}/agent-signup.md and lists it in {instance}/.well-known/agent-skills/index.json. The instance URL and catalog slug come from the product you are buying from, not from tansohq.com.

The optional MCP server is enabled and configured by the operator. Review the current MCP documentation rather than assuming a hosted URL. Confirm the intended task, permitted actions, and necessary human approval. Check the resulting product state, not merely a successful status code.

- [Open source](https://tansohq.com/product/agent-monetization.md)
- [MCP configuration](https://tanso.mintlify.app/mcp)
- [Quickstart](https://tanso.mintlify.app/quickstart)
- [Site index](https://tansohq.com/llms.txt)