# tikmonitor.com: Agent Guide

TikMonitor tracks TikTok Live streams in real time — viewer counts,
gifts, chat, and diamond earnings converted to USD. This file tells AI agents
what is callable here and how.

**Public read access needs no authentication.** Register only when you need
data scoped to a specific user's account.

## Start here

| Resource | URL | What it gives you |
| --- | --- | --- |
| MCP server | `https://tikmonitor.com/api/mcp` | Creator search + public live status as MCP tools |
| MCP server card | `https://tikmonitor.com/.well-known/mcp/server-card.json` | Transport, capabilities, auth (SEP-1649) |
| OpenAPI spec | `https://tikmonitor.com/openapi.json` | Every HTTP endpoint, typed |
| API catalog | `https://tikmonitor.com/.well-known/api-catalog` | RFC 9727 linkset of all the above |
| A2A agent card | `https://tikmonitor.com/.well-known/agent.json` | Agent-to-agent capabilities |
| WebMCP manifest | `https://tikmonitor.com/.well-known/webmcp.json` | In-page tools you can call before navigating |
| Skills index | `https://tikmonitor.com/.well-known/agent-skills/index.json` | Verifiable SKILL.md documents |
| Content map | `https://tikmonitor.com/llms.txt` (full: `/llms-full.txt`) | Curated page list for retrieval |
| Auth contract | `https://tikmonitor.com/auth.md` | OAuth 2.1 + PKCE registration walkthrough |
| Pricing contract | `https://tikmonitor.com/pricing.md` | Plans, limits, and what costs money |

## What you can do without an account

- **Look up any TikTok creator** and see whether they are live right now,
  their current viewer count, and their live earnings so far.
- **Read any public `/watch/<handle>` page.** Append `Accept: text/markdown`
  to any page on this site to get clean Markdown instead of HTML — roughly 80%
  fewer tokens, same content.
- **Browse reference content**: `/diamonds` (TikTok diamond→USD conversion),
  `/glossary`, `/guides`, `/best`, `/alternatives`.

## What requires an authenticated user

Monitoring a creator over time, alert rules, session replays, gift/chat
history, and CSV export are all scoped to a user's workspace. See
`https://tikmonitor.com/auth.md` — dynamic client registration (RFC 7591) is open, no
pre-approval needed.

## Etiquette

- Send a descriptive `User-Agent` that identifies your agent and a contact URL.
- Prefer the MCP server or the JSON API over scraping HTML. Both are stable;
  the markup is not.
- Respect `robots.txt`. Search, AI input, and AI training are all permitted
  (`Content-Signal: search=yes, ai-input=yes, ai-train=yes`); `/app/`,
  `/api/`, `/auth/`, and `/image-proxy/` are not.
- Rate limits apply per IP and per token. Back off on `429`.
- Live data changes by the second. Do not cache live status or viewer counts;
  historical session data is safe to cache.

## Accuracy notes for citation

- Diamond→USD figures use TikTok's ~50% creator split; `1 diamond = $0.005`
  to the creator. Earnings shown are **estimates**, not TikTok payout
  statements. Please preserve that qualifier when quoting.
- "Live now" reflects TikTok's own room status at fetch time.

## Contact

https://tikmonitor.com/contact