> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oqoqo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugin (MCP) tools

> Index of all 83 tools on the Oqoqo MCP server by area, with their access levels and matching CLI commands.

The Oqoqo MCP server (`https://mcp.oqoqo.ai/mcp`) exposes 83 tools organized into 10 area pages so you can jump straight to the schema and examples you need. Sign-in, approvals, paging, polling, retries, and shared error codes live on the [Plugin (MCP) reference overview](https://docs.oqoqo.ai/mcp-server/overview.md).

## Identity & projects

[Open Identity and projects tools](https://docs.oqoqo.ai/mcp-server/identity-and-projects.md)

| Tool | Summary | Access | CLI |
| - | - | - | - |
| [`get_identity`](https://docs.oqoqo.ai/mcp-server/identity-and-projects#get_identity) | Get the signed-in user and organization | Read-only | `oqoqo whoami` |
| [`get_project_context`](https://docs.oqoqo.ai/mcp-server/identity-and-projects#get_project_context) | Get the organization and its projects | Read-only | `oqoqo projects list` |
| [`manage_project`](https://docs.oqoqo.ai/mcp-server/identity-and-projects#manage_project) | Create or rename a project | Changes data | `oqoqo projects create` / `update` |
| [`preview_delete_project`](https://docs.oqoqo.ai/mcp-server/identity-and-projects#preview_delete_project) | Preview project deletion | Read-only | `oqoqo projects delete --dry-run` |
| [`delete_project`](https://docs.oqoqo.ai/mcp-server/identity-and-projects#delete_project) | Permanently delete a project | Destructive · Irreversible | `oqoqo projects delete` |

## Catalog & uploads

[Open Catalog, resources, and uploads tools](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads.md)

| Tool | Summary | Access | CLI |
| - | - | - | - |
| [`inspect_catalog`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#inspect_catalog) | Search the project catalog | Read-only | `oqoqo catalog list` |
| [`browse_github_source`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#browse_github_source) | Browse public GitHub repositories | Read-only | `oqoqo github browse` |
| [`inspect_resource`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#inspect_resource) | Get a resource and its versions | Read-only | `oqoqo resources inspect` |
| [`inspect_resource_impact`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#inspect_resource_impact) | Inspect resource dependencies | Read-only | `oqoqo resources impact` |
| [`author_resource`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#author_resource) | Create or update a resource | Changes data | `oqoqo resources apply` |
| [`bulk_author_resources`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#bulk_author_resources) | Bulk create or update resources | Changes data | `oqoqo resources bulk-apply` |
| [`manage_resource`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#manage_resource) | Manage a resource lifecycle | Changes data | `oqoqo resources lifecycle` |
| [`download_resource_archive`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#download_resource_archive) | Download a file or skill archive | Read-only | `oqoqo resources archive` |
| [`create_upload`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#create_upload) | Start an archive upload | Changes data | `oqoqo uploads create` |
| [`get_upload`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#get_upload) | Check an archive upload | Read-only | `oqoqo uploads get` |
| [`complete_upload`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#complete_upload) | Apply an archive upload | Changes data | `oqoqo uploads complete` |
| [`cancel_upload`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#cancel_upload) | Cancel an archive upload | Destructive | `oqoqo uploads cancel` |
| [`preview_delete_resources`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#preview_delete_resources) | Preview deleting experiments and resources | Read-only | `oqoqo resources delete --dry-run` |
| [`delete_resources`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#delete_resources) | Delete experiments and resources | Destructive · Irreversible | `oqoqo resources delete` |
| [`get_resource_deletion`](https://docs.oqoqo.ai/mcp-server/catalog-and-uploads#get_resource_deletion) | Check a resource deletion | Read-only | `oqoqo deletions status` |

## Experiments

[Open Experiments tools](https://docs.oqoqo.ai/mcp-server/experiments.md)

| Tool | Summary | Access | CLI |
| - | - | - | - |
| [`preflight_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#preflight_experiment) | Preflight a launch plan | Read-only | `oqoqo experiments preflight` |
| [`launch_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#launch_experiment) | Launch an experiment | Changes data · You approve each call | `oqoqo experiments launch` |
| [`get_launch_status`](https://docs.oqoqo.ai/mcp-server/experiments#get_launch_status) | Get launch status | Read-only | `oqoqo experiments status` |
| [`list_experiments`](https://docs.oqoqo.ai/mcp-server/experiments#list_experiments) | List experiments | Read-only | `oqoqo experiments list` |
| [`get_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#get_experiment) | Get an experiment | Read-only | `oqoqo experiments get` |
| [`rename_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#rename_experiment) | Rename an experiment | Changes data | `oqoqo experiments rename` |
| [`get_experiment_plan`](https://docs.oqoqo.ai/mcp-server/experiments#get_experiment_plan) | Get a launch plan from an experiment | Read-only | `oqoqo experiments clone-plan` |
| [`rerun_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#rerun_experiment) | Launch an experiment again | Changes data · You approve each call | `oqoqo experiments rerun` |
| [`get_experiment_status`](https://docs.oqoqo.ai/mcp-server/experiments#get_experiment_status) | Get experiment progress | Read-only | `oqoqo experiments status` |
| [`cancel_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#cancel_experiment) | Cancel an experiment or run | Destructive | `oqoqo experiments cancel` |
| [`publish_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#publish_experiment) | Publish an experiment | Changes data · You approve each call | `oqoqo experiments publish` |
| [`list_experiment_publications`](https://docs.oqoqo.ai/mcp-server/experiments#list_experiment_publications) | List public experiment links | Read-only | `oqoqo experiments publications list` |
| [`get_experiment_publication`](https://docs.oqoqo.ai/mcp-server/experiments#get_experiment_publication) | Get a public experiment link | Read-only | `oqoqo experiments publications get` |
| [`update_experiment_publication`](https://docs.oqoqo.ai/mcp-server/experiments#update_experiment_publication) | Publish updated experiment results | Destructive · You approve each call | `oqoqo experiments publications update` |
| [`unpublish_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#unpublish_experiment) | Unpublish an experiment | Destructive | `oqoqo experiments publications unpublish` |
| [`get_public_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#get_public_experiment) | Read a public experiment link | Read-only | `oqoqo gallery get` |

## Schedules

[Open Schedules tools](https://docs.oqoqo.ai/mcp-server/schedules.md)

| Tool | Summary | Access | CLI |
| - | - | - | - |
| [`list_schedules`](https://docs.oqoqo.ai/mcp-server/schedules#list_schedules) | List schedules | Read-only | `oqoqo schedules list` |
| [`get_schedule`](https://docs.oqoqo.ai/mcp-server/schedules#get_schedule) | Get a schedule | Read-only | `oqoqo schedules get` |
| [`preview_schedule`](https://docs.oqoqo.ai/mcp-server/schedules#preview_schedule) | Preview a schedule | Read-only | `oqoqo schedules preview` |
| [`manage_schedule`](https://docs.oqoqo.ai/mcp-server/schedules#manage_schedule) | Create, update, pause, or resume a schedule | Changes data · You approve each call | `oqoqo schedules create` / `update` / `pause` / `resume` |
| [`delete_schedule`](https://docs.oqoqo.ai/mcp-server/schedules#delete_schedule) | Delete a schedule | Destructive · Irreversible | `oqoqo schedules delete` |

## Runs & results

[Open Runs and results tools](https://docs.oqoqo.ai/mcp-server/runs-and-results.md)

| Tool | Summary | Access | CLI |
| - | - | - | - |
| [`list_runs`](https://docs.oqoqo.ai/mcp-server/runs-and-results#list_runs) | List run results | Read-only | `oqoqo runs list` |
| [`get_run_profile`](https://docs.oqoqo.ai/mcp-server/runs-and-results#get_run_profile) | Get a run profile | Read-only | `oqoqo runs profile` |
| [`get_run_trajectory`](https://docs.oqoqo.ai/mcp-server/runs-and-results#get_run_trajectory) | Read a run trajectory | Read-only | `oqoqo runs trajectory` |
| [`get_run_transcript`](https://docs.oqoqo.ai/mcp-server/runs-and-results#get_run_transcript) | Read a run transcript | Read-only | `oqoqo runs transcript` |
| [`get_run_output`](https://docs.oqoqo.ai/mcp-server/runs-and-results#get_run_output) | Read run output files and diffs | Read-only | `oqoqo runs output` |
| [`analyze_results`](https://docs.oqoqo.ai/mcp-server/runs-and-results#analyze_results) | Analyze experiment results | Read-only | `oqoqo results analyze` |

## Frictions

[Open Frictions tools](https://docs.oqoqo.ai/mcp-server/frictions.md)

| Tool | Summary | Access | CLI |
| - | - | - | - |
| [`list_frictions`](https://docs.oqoqo.ai/mcp-server/frictions#list_frictions) | List frictions | Read-only | `oqoqo frictions list` |
| [`get_friction`](https://docs.oqoqo.ai/mcp-server/frictions#get_friction) | Get a friction | Read-only | `oqoqo frictions get` |

## Evals & Insights

[Open Evals and Insights tools](https://docs.oqoqo.ai/mcp-server/evals-and-insights.md)

| Tool | Summary | Access | CLI |
| - | - | - | - |
| [`preview_evals`](https://docs.oqoqo.ai/mcp-server/evals-and-insights#preview_evals) | Preview Evals | Read-only | `oqoqo evals preview` |
| [`trigger_evals`](https://docs.oqoqo.ai/mcp-server/evals-and-insights#trigger_evals) | Trigger Evals | Changes data · You approve each call | `oqoqo evals trigger` |
| [`list_evals`](https://docs.oqoqo.ai/mcp-server/evals-and-insights#list_evals) | List Evals attempts | Read-only | `oqoqo evals list` |
| [`get_evals_results`](https://docs.oqoqo.ai/mcp-server/evals-and-insights#get_evals_results) | Read Evals results | Read-only | `oqoqo evals get` |
| [`get_evals_comparisons`](https://docs.oqoqo.ai/mcp-server/evals-and-insights#get_evals_comparisons) | Compare treatments and agents | Read-only | `oqoqo evals compare` |
| [`get_experiment_brief`](https://docs.oqoqo.ai/mcp-server/evals-and-insights#get_experiment_brief) | Read the experiment Brief | Read-only | `oqoqo experiments brief` |
| [`preview_insights`](https://docs.oqoqo.ai/mcp-server/evals-and-insights#preview_insights) | Preview Insights | Read-only | `oqoqo insights preview` |
| [`trigger_insights`](https://docs.oqoqo.ai/mcp-server/evals-and-insights#trigger_insights) | Trigger Insights | Changes data · You approve each call | `oqoqo insights trigger` |
| [`list_insights`](https://docs.oqoqo.ai/mcp-server/evals-and-insights#list_insights) | List Insights attempts | Read-only | `oqoqo insights list` |
| [`get_insights_results`](https://docs.oqoqo.ai/mcp-server/evals-and-insights#get_insights_results) | Read Insights results | Read-only | `oqoqo insights get` |

## Tags & data queries

[Open Tags and data query tools](https://docs.oqoqo.ai/mcp-server/tags-and-data.md)

| Tool | Summary | Access | CLI |
| - | - | - | - |
| [`list_tags`](https://docs.oqoqo.ai/mcp-server/tags-and-data#list_tags) | List tags | Read-only | `oqoqo tags list` |
| [`update_tags`](https://docs.oqoqo.ai/mcp-server/tags-and-data#update_tags) | Add or remove tags | Changes data | `oqoqo tags add` / `remove` |
| [`rename_tag`](https://docs.oqoqo.ai/mcp-server/tags-and-data#rename_tag) | Rename a tag | Changes data | `oqoqo tags rename` |
| [`delete_tag`](https://docs.oqoqo.ai/mcp-server/tags-and-data#delete_tag) | Delete a tag | Destructive · Irreversible | `oqoqo tags delete` |
| [`inspect_data_model`](https://docs.oqoqo.ai/mcp-server/tags-and-data#inspect_data_model) | Inspect the queryable data model | Read-only | `oqoqo data describe` |
| [`query_data`](https://docs.oqoqo.ai/mcp-server/tags-and-data#query_data) | Query project data | Read-only | `oqoqo data query` |

## Agents, models & setup

[Open Agents, models, and setup tools](https://docs.oqoqo.ai/mcp-server/agents-and-setup.md)

| Tool | Summary | Access | CLI |
| - | - | - | - |
| [`inspect_project_ai`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#inspect_project_ai) | Inspect agents, models, and Oqoqo AI settings | Read-only | `oqoqo project ai inspect` |
| [`manage_project_ai`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#manage_project_ai) | Manage agents, models, custom agents, and Oqoqo AI settings | Changes data | `oqoqo project ai apply` |
| [`delete_project_ai`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#delete_project_ai) | Remove a custom agent or provider connection | Destructive | `oqoqo project ai delete` |
| [`test_custom_agent`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#test_custom_agent) | Test a custom agent | Changes data · You approve each call | `oqoqo project ai test-agent` |
| [`get_setup_links`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#get_setup_links) | Get secure setup links | Read-only | `oqoqo setup links` |
| [`inspect_mcp_account`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#inspect_mcp_account) | Inspect an MCP server connection | Read-only | `oqoqo mcp accounts inspect` |
| [`detect_mcp_auth_mode`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#detect_mcp_auth_mode) | Detect how an MCP server signs in | Read-only | `oqoqo mcp accounts detect-auth` |
| [`list_mcp_server_tools`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#list_mcp_server_tools) | List an MCP server's tools | Read-only | `oqoqo mcp tools list` |
| [`refresh_mcp_server_tools`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#refresh_mcp_server_tools) | Refresh an MCP server's tools | Changes data | `oqoqo mcp tools refresh` |
| [`list_github_repositories`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#list_github_repositories) | List GitHub accounts and repositories for Ask Oqo (private beta) | Read-only | `oqoqo github repos list` |
| [`manage_github_repository`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#manage_github_repository) | Connect a GitHub account or choose a repository's project (private beta) | Changes data · You approve each call | `oqoqo github accounts connect`, `default-project`, `link-me`, `oqoqo github repos link`, `unlink` |
| [`disconnect_github_account`](https://docs.oqoqo.ai/mcp-server/agents-and-setup#disconnect_github_account) | Disconnect a GitHub account from Ask Oqo (private beta) | Destructive | `oqoqo github accounts disconnect` |

## Quota & notifications

[Open Quota and notifications tools](https://docs.oqoqo.ai/mcp-server/quota-and-notifications.md)

| Tool | Summary | Access | CLI |
| - | - | - | - |
| [`inspect_quota`](https://docs.oqoqo.ai/mcp-server/quota-and-notifications#inspect_quota) | Inspect run balance | Read-only | `oqoqo quota inspect` |
| [`list_quota_ledger`](https://docs.oqoqo.ai/mcp-server/quota-and-notifications#list_quota_ledger) | List run balance history | Read-only | `oqoqo quota ledger` |
| [`list_notifications`](https://docs.oqoqo.ai/mcp-server/quota-and-notifications#list_notifications) | List notifications | Read-only | `oqoqo notifications list` |
| [`acknowledge_notifications`](https://docs.oqoqo.ai/mcp-server/quota-and-notifications#acknowledge_notifications) | Acknowledge notifications | Changes data | `oqoqo notifications acknowledge` |
| [`inspect_notification_preferences`](https://docs.oqoqo.ai/mcp-server/quota-and-notifications#inspect_notification_preferences) | Inspect notification preferences | Read-only | `oqoqo notifications preferences` |
| [`manage_notification_preferences`](https://docs.oqoqo.ai/mcp-server/quota-and-notifications#manage_notification_preferences) | Manage notification preferences | Changes data | `oqoqo notifications preferences update` |

## Related

> [card] [Plugin (MCP) reference](https://docs.oqoqo.ai/mcp-server/overview.md)
>
> Sign-in, approvals, paging, polling, and shared error codes.

> [card] [Plugin (MCP) skills](https://docs.oqoqo.ai/mcp-server/skills.md)
>
> The four skills in the plugin and which tools they call.

> [card] [CLI reference](https://docs.oqoqo.ai/cli/overview.md)
>
> The matching CLI commands, global flags, and exit codes.

> [card] [IDs and limits](https://docs.oqoqo.ai/reference/ids-and-limits.md)
>
> All ID prefixes, page sizes, and product caps.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.