# tik.tools MCP prompt pack

Twelve plain-language prompts for Claude (or any MCP client) with the
`tiktok-live-mcp` server installed. Each prompt lists the tool Claude will call
and the lowest tik.tools plan that returns real data for it.

Plans, lowest to highest: Sandbox, Basic, Pro, Ultra, Agency Global.
Agency Starter has the same access as Pro for these tools.

## Install

You need a tik.tools API key from https://tik.tools/dashboard. Replace
YOUR_API_KEY below with it. Requires Node.js 18 or newer.

### Claude Code

```
claude mcp add tiktok-live -e TIKTOOLS_API_KEY=YOUR_API_KEY -- npx -y tiktok-live-mcp
```

### Claude Desktop

Settings > Developer > Edit Config, then add:

```json
{
  "mcpServers": {
    "tiktok-live": {
      "command": "npx",
      "args": ["-y", "tiktok-live-mcp"],
      "env": { "TIKTOOLS_API_KEY": "YOUR_API_KEY" }
    }
  }
}
```

Restart Claude Desktop after saving.

### Cursor

Same block as Claude Desktop, in `~/.cursor/mcp.json`.

### VS Code

In `.vscode/mcp.json` (note the top-level key is `servers`):

```json
{
  "servers": {
    "tiktok-live": {
      "command": "npx",
      "args": ["-y", "tiktok-live-mcp"],
      "env": { "TIKTOOLS_API_KEY": "YOUR_API_KEY" }
    }
  }
}
```

Check it works: ask "What plan am I on and how many requests do I have left today?"

## Prompts

### 1. Check my plan and limits
> What tik.tools plan am I on, and how many API requests and live connections do I have left?

Tool: `get_rate_limits`. Plan: any, including Sandbox.

### 2. Is one creator live right now?
> Is @creator_name live on TikTok right now? If yes, give me the room id.

Tool: `get_live_status`. Plan: any, including Sandbox.

### 3. Which of my creators are live?
> Here are my creators: @creator_one, @creator_two, @creator_three. Which of them are live right now, and how many viewers does each have?

Tool: `check_live`. Plan: Basic or higher.

### 4. What is happening in a live room?
> @creator_name is live. Give me the stream title, viewer count and likes so far.

Tool: `get_room_info`. Plan: Basic or higher.

### 5. Creator profile
> Look up @creator_name: followers, following, bio, and whether the account is verified.

Tool: `get_creator_profile`. Plan: Pro or higher.

### 6. Gift values
> How many diamonds is a Rose worth, and what are the five most expensive gifts?

Tool: `get_gift_catalog`. Plan: any. Sandbox and Basic search a 50-gift sample; Pro and higher search the full catalog.

### 7. A creator's gift gallery
> Show me this week's gift gallery for @creator_name: which gallery gifts are lit and which are still missing.

Tool: `get_gift_gallery`. Plan: Ultra or higher. Lower plans get a clearly marked sample so you can see the shape of the data.

### 8. Live streams to watch
> Pull 10 streams from the live feed and list them by viewer count, with title and follower count.

Tool: `get_live_feed`. Plan: Pro or higher.

### 9. Today's top creators
> Who are the top 20 creators on today's US leaderboard?

Tool: `get_leaderboard` (type daily). Plan: Pro or higher for named rows. Sandbox and Basic return the board without creator rows.

### 10. League standings
> Show me the current US league leaderboard with each creator's score.

Tool: `get_leaderboard` (type league). Plan: Ultra or higher. Weekly, gaming and shopping boards need Agency Global.

### 11. Popular LIVE in a region
> Which creators are on the Popular LIVE board in Germany right now?

Tool: `get_popular_live`. Plan: Agency Global for every row unmasked. Lower plans get a masked board.

### 12. Recruit shortlist
> Find 25 creators in the UK who are eligible to recruit, with a score above 1000, and give me their handles, current league and score.

Tool: `find_eligible_creators`. Plan: Agency Global.

## Tips

- Name the region with a country code (US, UK, DE, BR). Claude passes it straight to the tool.
- Ask for a table and Claude will format the results as one.
- If a prompt needs a higher plan, the tool says so in its answer instead of failing silently.
