Authentication
All requests require a bearer token:
Authorization: Bearer tc_live_•••
Get your key from the dashboard. Free tier = 100 calls/month.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| url | string | ✓ | Full URL including https:// |
| format | enum | — | A4, A3, A5, Letter, Legal, Tabloid. Default A4. |
| landscape | boolean | — | Landscape orientation. |
Response
All responses are JSON with snake_case keys. On success, the tool-specific data is returned. On error, the body has at minimum an error field with a human-readable message.
Rate-limit headers are always included:
X-RateLimit-Limit— monthly quotaX-RateLimit-Remaining— calls left this monthX-RateLimit-Reset— Unix timestamp of next resetX-Plan— current plan nameX-Request-Id— for support tickets
MCP usage
This tool is exposed as an MCP server tool. Add to your Claude Desktop / Cursor / Claude Code config:
claude_desktop_config.json
{
"mcpServers": {
"toolcenter": {
"command": "npx",
"args": ["-y", "toolcenter-mcp"],
"env": { "TOOLCENTER_API_KEY": "tc_live_•••" }
}
}
}
Full guide: MCP install.
Errors
| Status | When |
|---|---|
| 400 | Missing or invalid parameter (validation failed). |
| 401 | API key missing or invalid. |
| 403 | IP not whitelisted, or URL points to a private / metadata address. |
| 429 | Monthly quota exhausted — see X-RateLimit-Reset. |
| 503 | Upstream service (worker / search) temporarily unavailable. |