# 3Dogs public agent guide

This file describes how automated assistants may interact with the public 3Dogs website and its published agent interfaces. It does not grant access to private systems, confidential information, accounts, subscriptions, or payment methods.

## Discovery

- Public site: https://3dogs.ai/
- Product documentation: https://3dogs.ai/products/
- 3Dogs Pointer Agent Card: https://3dogs.ai/.well-known/agent-card.json
- MCP Server Card: https://3dogs.ai/.well-known/mcp/server-card.json
- API catalog: https://3dogs.ai/.well-known/api-catalog
- OpenAPI document: https://3dogs.ai/openapi.json
- Agent Skills index: https://3dogs.ai/.well-known/agent-skills/index.json
- OAuth authorization metadata: https://3dogs.ai/.well-known/oauth-authorization-server
- OAuth protected-resource metadata: https://3dogs.ai/.well-known/oauth-protected-resource
- Human-readable authentication guide: https://3dogs.ai/auth.md
- Sitemap: https://3dogs.ai/sitemap.xml

## Installation

No package installation is required for public discovery. Fetch the published HTTPS resources above. An MCP client connects to `https://3dogs.ai/mcp`; an A2A client connects to `https://agent.3dogs.ai/a2a` and sends `A2A-Version: 1.0`.

## Configuration

- Public reading and discovery do not require credentials.
- Use `Accept: text/markdown` on public HTML URLs when a compact machine-readable representation is preferred.
- The anonymous Pointer demonstration requires the caller to declare `human_authorized: true`; that declaration is not authentication or proof of consent.
- OAuth-protected actions use the authorization metadata at `https://3dogs.ai/.well-known/oauth-authorization-server` and the minimum scope needed for the exact action.

## Usage examples

- Read the homepage as Markdown: `GET https://3dogs.ai/` with `Accept: text/markdown`.
- Discover Pointer: `GET https://3dogs.ai/.well-known/agent-card.json`.
- Discover MCP: `GET https://3dogs.ai/.well-known/mcp/server-card.json`, then initialize `https://3dogs.ai/mcp`.
- Verify an answer: call the MCP tool `verify_ai_answer` with the strategic question, the answer exactly as supplied, and the human-authorization declaration.
- Review plans without commitment: call `GET https://3dogs.ai/commerce/checkout-sessions`; any checkout continuation remains human-controlled.

## Allowed public uses

- Read, summarize, quote, and cite public pages.
- Discover 3Dogs Pointer through its Agent Card.
- Use the published anonymous Pointer demonstration within its stated limits.
- Prepare a free-account claim or checkout handoff only when the human explicitly authorizes the exact action and supplied information.

## Human-control boundary

- A caller-provided `human_authorized` value is a declaration, not proof of identity or consent.
- Do not submit confidential, privileged, regulated, or payment-card information to anonymous interfaces.
- Agents may prepare a checkout handoff, but they may not accept terms, choose a paid commitment, create a subscription, or approve a real-money payment for the human.
- The x402 receipt is a Base Sepolia testnet demonstration and requires a separate, exact, short-lived human mandate.
- 3Dogs provides decision support. The human retains the decision and accountability.

## Content-use signal

Public responses use `Content-Signal: ai-train=no, search=yes, ai-input=yes`: public content may be indexed for search and used to ground answers, but it is not offered for model training or fine-tuning.

## Contact

For integration or enterprise questions, use the contact path published at https://3dogs.ai/#contact.