---
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. The site does not offer a hosted billing API, billing MCP server, OAuth server, product signup, or automated product evaluation.

## 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.

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)