Automations
162
Modify Tool Blueprint Node
Add, edit, or remove a blueprint node in an existing tool by slug using a single interface (op=add/edit/remove). Returns { ok: true } on success, or validation errors.
Get Doc
Fetch the raw markdown content for a Starships documentation page by slug (nested slugs supported, no extension). Returns { slug, title, content }.
Search Docs
Search Starships documentation by query and return a ranked list of matching pages (supports limit; empty query returns a lightweight listing).
List Models
List available LLM models from the Starships model catalog (provider/model IDs plus metadata like pricing/context). Use this to choose a model before creating or editing agents.
Unassign Agent Tool
Unassign a tool from an agent by slug on the current starship (deletes the Agent→Tool relationship). Returns { ok: true } on success.
Assign Agent Tool
Assign a tool to an agent by slug on the current starship (creates an Agent→Tool relationship). Returns { ok: true } on success.
Edit Agent
Update an existing agent by slug with partial fields (name, role, description, model, systemPrompt, temperature, maxTokens, blueprint, timeout, previewPrompts). Returns a lean agent summary (no blueprint/state).
Open Agent
Create a new draft agent (provide name + role; optional description/model/settings) or open an existing agent by slug on the current starship. Returns a lean agent summary (no blueprint/state).
Get Agent
Fetch complete agent details by slug from the current starship (includes blueprint, systemPrompt, assignedToolSlugs, and other configuration).
List Agents
List all agents on the current starship for discovery. Returns a lean array (slug, name, description, category) without heavy fields like blueprint.
Edit Tool
Update an existing tool by slug with partial fields (name, description, parameters, blueprint) on the current starship. Returns a lean tool summary (no blueprint).
Edit Tool
Update an existing tool by slug with partial fields (name, description, parameters, blueprint) on the current starship. Returns a lean tool summary (no blueprint).
Test Tool
Execute another tool by slug with optional arguments and report ok/fail plus duration. Fetches the tool definition first, then runs its blueprint (may have side effects).
Test Tool
Execute another tool by slug with optional arguments and report ok/fail plus duration. Fetches the tool definition first, then runs its blueprint (may have side effects).
Edit Tool
Update an existing tool by slug with partial fields (name, description, parameters, blueprint) on the current starship. Returns a lean tool summary (no blueprint).
Open Tool
Create a new tool (provide name + description; server generates slug) or open an existing tool by slug on the current starship. Returns a lean tool summary (no blueprint).
Get Tool
Fetch full tool details by slug from the current starship (includes blueprint and parameters).
List Tools
List all tools deployed on the current starship for discovery (not a permission list). Returns a lean array (slug, name, description, category) without heavy fields like blueprint.