MCP Tool Reference

The Routebase MCP server exposes 401 tools across 31 groups. Each tool maps to a Routebase capability — designing specs, running tests, managing mock servers, authoring docs — and is gated by the scopes of the API key you connect with. Visibility is staged: a lean core set is advertised by default, and the agent enables further groups on demand with enable_toolset (see list_toolsets). Hidden tools stay callable — staging only affects what tools/list advertises.

This reference is generated directly from the server's tool definitions and synced through the Routebase MCP server itself, so it never drifts from the live API.

Before calling any module tool, set your working context with set_context (organization, and usually a project).

Tool groups

Group	Count	Tools
API Specifications	8	`create_spec`, `delete_spec`, `export_spec`, `get_spec`, `import_spec`, `list_specs`, `update_spec`, `validate_spec`
Auth Configuration	5	`delete_environment_auth`, `get_environment_auth`, `set_environment_auth`, `set_suite_auth`, `set_testcase_auth`
Branches & Merge Requests	10	`get_branch`, `get_merge_policy`, `get_merge_request`, `list_branches`, `list_merge_requests`, `manage_branch`, `manage_merge_request`, `merge_merge_request`, `review_merge_request`, `update_merge_policy`
Context & Session	6	`enable_toolset`, `get_session_usage`, `list_organizations`, `list_projects`, `list_toolsets`, `set_context`
Deprecation	10	`force_advance_deprecation`, `get_deprecation_plan`, `get_deprecation_policy`, `list_deprecations`, `manage_deprecation_plan`, `notify_dependent_owners`, `retire_deprecation`, `review_deprecation_plan`, `set_version_sunset`, `update_deprecation_policy`
Documentation	30	`clone_doc_version`, `create_doc_folder`, `create_doc_page`, `create_documentation`, `get_doc_page`, `get_doc_page_revision`, `get_doc_settings`, `get_doc_snippet`, `get_doc_tree`, `get_doc_version_publish_state`, `get_org_doc_template`, `get_portal_url`, `get_spec_usage_in_docs`, `list_available_specs`, `list_doc_page_revisions`, `list_doc_snippets`, `list_documentations`, `list_org_doc_templates`, `manage_doc_folder`, `manage_doc_page`, `manage_doc_snippet`, `manage_doc_tree`, `manage_doc_version`, `manage_org_doc_template`, `manage_snapshot_content`, `manage_spec_snapshot`, `publish_doc_version`, `trigger_portal_build`, `update_doc_page`, `update_doc_settings`
Endpoints	19	`add_parameter`, `add_response`, `add_security_scheme`, `bulk_update_endpoints`, `create_endpoint`, `delete_endpoint`, `delete_parameter`, `delete_request_body`, `delete_response`, `get_endpoint`, `list_endpoints`, `manage_response_header`, `move_endpoint_to_folder`, `remove_endpoint_security_scheme`, `restore_endpoint`, `set_request_body`, `update_endpoint`, `update_parameter`, `update_response`
Folders	6	`create_folder`, `delete_folder`, `list_folders`, `move_folder`, `reorder_folders`, `update_folder`
Governance	6	`get_breaking_changes`, `get_header_policies`, `get_style_guide_rules`, `get_versioning_strategy`, `lint_spec`, `set_versioning_strategy`
Header Components	7	`delete_header_component`, `get_header_component`, `get_org_header_component`, `list_header_components`, `list_org_header_components`, `manage_header_component`, `manage_org_header_component`
Header Policies	10	`delete_header_policy`, `get_header_policy`, `get_org_header_policy`, `get_resolved_headers`, `list_header_exclusions`, `list_header_policies`, `list_org_header_policies`, `manage_header_exclusion`, `manage_header_policy`, `manage_org_header_policy`
Mock Server	25	`clear_request_logs`, `create_mock_rule`, `create_mock_server`, `delete_mock_rule`, `delete_mock_server`, `generate_rules_from_spec`, `get_mock_rule_diagnostics`, `get_mock_server`, `get_mock_usage`, `get_org_mock_defaults`, `get_request_logs`, `list_mock_rules`, `list_org_builtin_rules`, `list_org_smart_mock_rules`, `list_smart_mock_matching_rules`, `manage_mock_rule_ops`, `manage_org_builtin_rules`, `manage_org_smart_mock_rule`, `manage_smart_mock_matching_rule`, `preview_smart_mock`, `regenerate_mock_server_token`, `test_smart_mock`, `update_mock_rule`, `update_mock_server`, `update_org_mock_defaults`
Monitoring	21	`generate_monitors_from_spec`, `get_alert_policy`, `get_contract_drift`, `get_monitor`, `get_monitoring_settings`, `get_monitoring_sync_status`, `get_schema_drift_report`, `list_alert_policies`, `list_contract_drift`, `list_incidents`, `list_maintenance_windows`, `list_monitor_checks`, `list_monitors`, `manage_alert_policy`, `manage_drift_event`, `manage_drift_watch`, `manage_incident`, `manage_maintenance_window`, `manage_monitor`, `manage_monitor_alert`, `update_monitoring_settings`
Navigation & Search	2	`get_dashboard`, `search`
Notifications & Webhooks	14	`create_webhook`, `delete_webhook`, `get_notification_preferences`, `list_notifications`, `list_webhook_deliveries`, `list_webhooks`, `mark_all_notifications_read`, `mark_notification_read`, `regenerate_webhook_secret`, `test_webhook`, `toggle_webhook`, `update_notification_preferences`, `update_org_notification_defaults`, `update_webhook`
Organization & Access (read-only)	7	`get_custom_role`, `get_my_permissions`, `list_custom_roles`, `list_members`, `list_project_teams`, `list_team_projects`, `list_teams`
Plan & Usage (read-only)	4	`get_credit_balance`, `get_subscription`, `get_trial`, `get_usage_limits`
Portal Administration	10	`get_custom_domain_status`, `get_portal_analytics`, `get_portal_build`, `get_portal_deployments`, `get_portal_preview`, `get_portal_settings`, `list_page_feedback`, `list_portal_builds`, `manage_custom_domain`, `manage_portal`
Portal Docs Search	2	`get_portal_page`, `search_portal_docs`
Projects & Environments	13	`create_environment`, `create_project`, `delete_environment`, `delete_project`, `get_environment_variables`, `get_project`, `get_project_settings`, `list_environments`, `set_environment_readonly`, `set_environment_variables`, `update_environment`, `update_project`, `update_project_settings`
Promotions, Sync & Audit	3	`get_audit_log`, `list_artifact_sync_reviews`, `list_promotions`
Request Body Components	5	`create_request_body_component`, `delete_request_body_component`, `get_request_body_component`, `list_request_body_components`, `update_request_body_component`
Reusable Components	10	`get_parameter_component`, `get_response_component`, `get_security_scheme_component`, `list_parameter_components`, `list_response_components`, `list_security_scheme_components`, `manage_parameter_component`, `manage_response_component`, `manage_response_component_header`, `manage_security_scheme_component`
Schemas	7	`create_schema`, `delete_schema`, `get_schema`, `list_schemas`, `migrate_schema_links`, `restore_schema`, `update_schema`
Security	14	`cancel_scan_run`, `export_findings_sarif`, `get_finding_remediation`, `get_security_findings`, `get_security_score`, `list_personas`, `list_scan_profiles`, `list_scan_runs`, `list_security_guidance`, `manage_persona`, `manage_scan_profile`, `run_security_scan`, `test_persona`, `update_finding_status`
Shared Library	12	`fork_org_component_to_project`, `get_shared_response`, `get_shared_schema`, `list_shared_component_usages`, `list_shared_responses`, `list_shared_schemas`, `manage_org_shared_response`, `manage_org_shared_schema`, `manage_shared_component_link`, `manage_shared_response`, `manage_shared_schema`, `promote_to_shared_library`
Style Guide & Governance	13	`delete_custom_style_guide_rule`, `get_governance_config`, `get_governance_score`, `get_org_style_guide_settings`, `list_custom_style_guide_rules`, `list_governance_alerts`, `list_project_style_guide_rules`, `manage_custom_style_guide_rule`, `manage_org_style_guide_rule`, `manage_project_style_guide_rule`, `resolve_governance_alert`, `update_governance_config`, `update_org_style_guide_config`
Tags	9	`bulk_update_tags`, `create_tag`, `delete_tag`, `generate_tags_from_paths`, `get_tag`, `list_tags`, `reorder_tags`, `set_endpoint_tags`, `update_tag_description`
Testing	87	`add_assertion`, `add_response_extraction`, `add_scenario_step`, `add_wait_step`, `bulk_delete_test_runs`, `check_schema_drift`, `copy_environment_auth`, `create_fixture`, `create_scenario`, `create_seed`, `create_test_case`, `create_test_case_with_request`, `create_test_suite`, `delete_assertion`, `delete_fixture`, `delete_request_config`, `delete_response_extraction`, `delete_scenario`, `delete_scenario_step`, `delete_snapshot`, `delete_test_case`, `delete_test_suite`, `export_test_run`, `get_cli_run_status`, `get_contract_summary`, `get_environment_verification`, `get_fixture`, `get_fixture_usage`, `get_linked_endpoint_contract`, `get_request_config`, `get_resolved_auth`, `get_test_result`, `get_test_results`, `get_test_run`, `get_test_suite`, `get_testing_settings`, `link_endpoint`, `list_fixture_imports`, `list_fixtures`, `list_linkable_endpoints`, `list_oauth2_tokens`, `list_org_fixtures`, `list_scenario_runs`, `list_scenarios`, `list_script_snippets`, `list_seeds`, `list_shared_reports`, `list_snapshots`, `list_test_cases`, `list_test_data_sets`, `list_test_folders`, `list_test_schedules`, `list_test_suites`, `manage_fixture_import`, `manage_oauth2_token`, `manage_org_fixture`, `manage_request_header`, `manage_script_snippet`, `manage_seed`, `manage_shared_report`, `manage_test_data_set`, `manage_test_folder`, `manage_test_schedule`, `move_test_item_to_folder`, `record_snapshot`, `reorder_response_extractions`, `reorder_scenario_steps`, `reorder_test_items`, `restore_fixture_version`, `restore_snapshot`, `run_scenario`, `run_seed`, `run_test_case`, `run_test_suite`, `set_test_case_request`, `sync_test_from_spec`, `test_auth_config`, `unlink_endpoint`, `update_assertion`, `update_fixture_content`, `update_fixture_metadata`, `update_response_extraction`, `update_scenario`, `update_scenario_step`, `update_test_case`, `update_test_suite`, `update_testing_settings`
Variables	8	`export_variables`, `get_secret_audit_log`, `import_variables`, `list_org_variables`, `list_personal_variables`, `manage_org_variable`, `manage_personal_variable`, `resolve_variables`
Versions	18	`cancel_scheduled_publish`, `compare_versions`, `create_version`, `delete_version`, `generate_changelog`, `get_environment_pins`, `get_publish_history`, `get_scheduled_publishes`, `get_version`, `list_versions`, `manage_version_status`, `pre_publish_impact`, `promote_version`, `publish_version`, `rollback_environment_pin`, `schedule_publish`, `set_version_alias`, `update_version`