Skip to content
truescrape
Free key

Contents

Site

Agents & tools

From an agent, a terminal, or a skill

Three ways in, one pipeline underneath. A call from an MCP tool, the CLI or curl is cached, charged and refunded by the same code, so nothing here can bill differently from the HTTP API.

MCP server

The server is remote. Register one URL with your key in a header and the agent gets every endpoint as a tool, each with its credit cost inline and the billing rules stated once at handshake. There is no local process to keep running. The exception is Claude Desktop, which only launches local servers, so it runs a small bridge from the CLI instead.

Replace YOUR_API_KEY with a key from the dashboard. Signed in, Agent integrations shows these same blocks with your key already in them.

Server
https://api.truescrape.com/mcp
Transport · protocol
http · 2025-06-18
Claude Code
claude mcp add --transport http truescrape https://api.truescrape.com/mcp \
  --header "x-api-key: YOUR_API_KEY" --scope user
Cursor — ~/.cursor/mcp.json
{
  "mcpServers": {
    "truescrape": {
      "url": "https://api.truescrape.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}
VS Code — .vscode/mcp.json
{
  "servers": {
    "truescrape": {
      "type": "http",
      "url": "https://api.truescrape.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}
Claude Desktop — claude_desktop_config.json (macOS and Linux)
{
  "mcpServers": {
    "truescrape": {
      "command": "npx",
      "args": [
        "-y",
        "truescrape",
        "mcp"
      ],
      "env": {
        "TRUESCRAPE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
on Windows, or to let the CLI write any of these files
npx truescrape agent add claude-desktop
check it answers — tools/list
curl -s -X POST "https://api.truescrape.com/mcp" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Bulk work belongs on POST /v1/jobs/batch, which is HTTP-only. An MCP client cannot call it, and the handshake says so, because being told beats looping one tool over a list.

CLI

Every endpoint is a command, <platform> <action>, with each query parameter as a flag. The commands are generated from the API’s own OpenAPI spec, so the CLI knows what the server serves rather than what it knew when it was built.

install
npm install -g truescrape

# or run it without installing anything
npx truescrape --help
first run
truescrape auth login
truescrape list
truescrape youtube channel --handle @mkbhd

Data goes to stdout. The billing line — what the call cost, what is left, whether it was served from cache — goes to stderr, so a pipe sees only the JSON. The key comes from truescrape auth login, from TRUESCRAPE_API_KEY, or from --api-key.

paging, batches, balance
# follow every page and pipe the JSON on
truescrape youtube channel-videos --handle @mkbhd --all | jq

# a batch of transcripts, waited on until it settles
truescrape batch youtube transcript --targets ids.json --wait

# credits left
truescrape balance

The same package writes agent configs. npx truescrape agent add <target> takes claude-code, claude-desktop, cursor or vscode. Source, issues and releases are in the public repository.

Agent skill

A skill is a short document an agent reads before it uses a tool. Where a tool description says what an endpoint takes, the skill says how to use the API well, which is the part a description is too short to carry. It installs into any agent that reads the skills format: Claude Code, Cursor, Codex, Copilot, Gemini CLI and Windsurf.

any agent
npx skills add TrueScrape/truescrape

In Claude Code the skill and the MCP server install together as a plugin. The server it registers reads TRUESCRAPE_API_KEY from the environment.

Claude Code plugin
claude plugin marketplace add TrueScrape/truescrape
claude plugin install truescrape@truescrape

Machine-readable

Everything above is built from these three files. Point a model at them directly and it can work out what a call will cost before it makes it.

  • /llms.txtThe API described in prose, sized for a context window.
  • /openapi.jsonEvery operation with its price inline as x-credit-cost.
  • /.well-known/mcpThe MCP URL, transport and auth header the snippets above were built from.
Public repositorySnippets with your keyBrowse every endpoint