Agents & tools
Add TrueScrape to your agent
Pick your agent, paste the config, and ask it for public social data. Every tool shows its credit cost, and failed or empty calls cost nothing. This page is the reference; for what an agent can do with it, start at Agents.
claude mcp add --transport http truescrape https://api.truescrape.com/mcp \
--header "x-api-key: YOUR_API_KEY" --scope userLoad only some platforms
Every platform loads by default. A smaller set keeps your agent’s context lean.
1,000 credits, once, no card. Paste it where the config says YOUR_API_KEY. Once you have a key, Agent integrations can fill it in for you.
Then ask
“Compare what Amazon and Walmart list for standing desks under $300, then check what Reddit says about the top three”
amazon_search · 3 credits, then walmart_search · 3 credits, then reddit_search · 1 credit per product
“Watch Acme's YouTube channel and tell me what's new each time I ask”
create_monitor · free to create, then check_monitor · the feed's normal price per check, stated in the response, then get_monitor_mentions · free to read
“Who is talking about Acme right now? Group it by source and flag what needs a reply”
find_mentions · up to 10 credits, 1 per source that answers; failed or empty sources are free
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
One URL and your key. Claude Code, Cursor, VS Code and Claude Desktop.
CLI
Every endpoint as a command. Data on stdout, the billing line on stderr.
Agent skill
Tells an agent how to use the API well, not just which tools exist.
Machine-readable
llms.txt, openapi.json and MCP discovery at stable URLs.
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
npx truescrape agent add <target>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.
npm install -g truescrape
# or run it without installing anything
npx truescrape --helptruescrape auth login
truescrape list
truescrape youtube channel --handle @mkbhdData 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.
# 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 balanceThe 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.
npx skills add TrueScrape/truescrapeIn 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 plugin marketplace add TrueScrape/truescrape
claude plugin install truescrape@truescrapeMachine-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.