MCP tools
Orchestor MCP tools let your agent investigate workspace data and turn findings into actions. Describe the brand, date range, and task so the agent can select tools and provide their arguments.
Sign in and grant workspace access
- Connect your client to
https://mcp.orchestor.io/mcp. - Complete OAuth in your browser and select the workspace.
- Choose Read-only for analysis, or the required write access for changes.
Registering the server URL does not complete authorization. Ask your agent to list brands to verify access. If results are missing, check the authorized workspace and filters. An empty list alone does not mean authentication failed.
Frequently used tools
| Tool | Purpose |
|---|---|
| brands_list | List workspace brands, optionally filtered to owned brands or direct competitors. |
| answers_list | Retrieve collected AI answers filtered by brand, prompt, platform, date range, and other conditions. |
| answers_get | Retrieve a collected AI answer by its ID. |
| get_visibility_report | Retrieve a visibility report with a selected scope, metrics, dimensions, and date range. |
| get_citations_report | Retrieve a report on citation frequency. |
| search_tools | Find additional read-only tools by purpose or name. Write and preview operations are excluded. |
For example, ask: “Compare the selected brand’s visibility over the last seven days with the previous seven days, then inspect the supporting AI answers.” The agent can combine multiple tools.
Tools by category
Discovery, preview, and writes
This directory covers the hosted core tools. Available tools depend on the connection's permissions and server configuration; check tools/list for the current session.
Use search_tools → get_tool_schema → execute_tool to find and run additional read-only tools. Write and preview operations are excluded from this discovery path.
prompts_create previews validation without saving a prompt. create_issue saves an issue and requires write access. Check the operation and target before requesting a change.