# Botster — MCP server on mcp.ai
> Connect your Botster account and use 11 tools for web scraping straight from your AI agent. Connect with your own API key. Botster automates web data collection through configurable bots, job lifecycle management, and structured run results.

By: mcp.ai · official
Page: https://mcp.ai/botster

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_botster?ms=1787293500000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/botster/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/botster/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/botster/skill.md
Postman collection (v2.1): https://mcp.ai/botster/postman.json

## Tools
- botster_calculate_bot_cost(input: string|string[], options?: object, bot_slug: string) — Calculate the credit price of one intended bot launch using the same input and bot-specific options, without launching the bot or spending credits.
- botster_delete_job(job_id: string) — Permanently delete one Botster job. This destructive action cannot be undone, is not the same as archiving, and may remove access to the job's run history.
- botster_delete_run(run_id: string) — Permanently delete one Botster data run and its stored results without deleting the entire job. This destructive operation cannot be undone.
- botster_get_credits() — Return the connected Botster account's available credit balance; use this before launching or restarting credit-consuming work.
- botster_get_job(job_id: string) — Get one job's status and data-run identifiers required to retrieve run results. The complete provider job object is returned without discarding bot-specific fields.
- botster_get_run_results(run_id: string) — Return the complete bot-specific JSON for one data run identified from GET_JOB in the results field. The provider's result shape is preserved.
- botster_launch_bot(input: string|string[], options?: object, webhook?: string, bot_slug: string) — Launch a Botster bot, creating external work that may spend account credits. Use CALCULATE_BOT_COST with the same input and options first when cost matters. Returns launch metadata and normalizes an i
- botster_list_bots(per?: integer, search?: string, next_cursor?: string) — List or search bots available to the connected account and return their identifiers for cost calculation and launch.
- botster_list_jobs(per?: integer, next_cursor?: string) — List jobs belonging to the connected Botster account and return job identifiers for inspection or lifecycle actions.
- botster_restart_job(job_id: string) — Restart an existing Botster job, creating renewed external work that may repeat the bot's effects and spend additional account credits. The renewed job identity may differ from the original; returns a
- botster_set_job_archived(job_id: string, archived: boolean) — Archive a Botster job or restore it from the archive by setting its desired archived state. This reversible action changes organization state but does not delete the job.

## Example prompts
- "What can I do in Botster?"
- "Show me a summary of my Botster account"

## Links
Docs: https://mcp.ai/docs/mcps/botster
Website: https://mcp.ai/mcps/botster