Oracle OCI Cloud Guard MCP Server – Security Findings
Oracle's OCI Cloud Guard MCP Server is an official reference implementation that exposes selected Oracle Cloud Guard problem-management functions through the Model Context Protocol. It is useful when an AI agent needs to inspect Cloud Guard findings, retrieve problem details, or update problem status using the permissions of an authenticated OCI profile.
Overview
The Oracle OCI Cloud Guard MCP Server is part of Oracle's official oracle/mcp repository, which contains reference MCP servers for Oracle products. This specific server connects AI-capable MCP clients to Oracle Cloud Guard, Oracle Cloud Infrastructure's security posture and threat-detection service. Its documented scope is focused on Cloud Guard problems rather than general OCI administration.
What the MCP server enables
The server exposes a small, security-focused tool set for Cloud Guard problem workflows:
list_problemslists problems in a specified compartment.get_problem_detailsretrieves details for a Cloud Guard problem by OCID.update_problem_statusupdates the status of a problem.
These tools let an AI agent help security and cloud operations teams triage findings, summarize problem context, and assist with status updates. The server does not claim to expose every Cloud Guard capability; it implements selected functions for managing Cloud Guard problems.
When to use it
Use this MCP server when an assistant needs live Cloud Guard context during security reviews, cloud posture investigations, or incident triage. Practical examples include asking an agent to list current Cloud Guard problems in a compartment, retrieve the full details for a specific problem OCID, or help prepare an operator decision before changing a problem's status.
Connection and authentication
Oracle documents both STDIO and HTTP streaming modes. For local MCP clients, the documented STDIO command is uvx oracle.oci-cloud-guard-mcp-server. For HTTP streaming, the server is started with ORACLE_MCP_HOST and ORACLE_MCP_PORT; Oracle's repository-level instructions show HTTP-capable OCI MCP servers being reached at the /mcp path.
For OCI MCP servers using STDIO, Oracle instructs users to install the OCI CLI and configure an OCI CLI profile. Actions run with the permissions of that configured OCI profile. HTTP-capable OCI MCP servers use Oracle IAM confidential-application settings, including IDCS-related environment variables and a registered callback URL, when deployed in that mode.
Key considerations
Oracle describes the repository as proof-of-concept/reference implementations for exploration, prototyping, and learning, not as production-ready software. Because Cloud Guard problem data and status changes are security-sensitive, use least-privilege OCI IAM policies, protect OCI configuration files and credentials, avoid exposing local HTTP listeners beyond localhost unless intentionally secured, and review any status-changing action before allowing an agent to execute it.
Supported Transports
streamable_http
URL: http://127.0.0.1:8888/mcp
stdio
Command: uvx
Args:
oracle.oci-cloud-guard-mcp-server
Frequently Asked Questions
- When should an AI agent use the Oracle OCI Cloud Guard MCP Server?
- Use it when an agent needs to work with Oracle Cloud Guard problems during security triage, cloud posture review, or OCI compartment investigations. The documented tools are aimed at listing problems, retrieving details, and updating a problem's status.
- What does this MCP server add to an AI agent's capabilities?
- It gives the agent live MCP tool access to selected Oracle Cloud Guard problem-management operations instead of relying on static knowledge. The agent can request current problem lists for a compartment and inspect a specific problem by OCID when the configured OCI identity permits it.
- What can the AI agent access or manage through this server?
- The verified tools are `list_problems`, `get_problem_details`, and `update_problem_status`. The server is not documented as a full Cloud Guard administration interface, so the YAML only describes problem listing, detail retrieval, and status updates.
- How is authentication configured for this MCP server?
- For STDIO use, Oracle instructs users to install the OCI CLI and configure an OCI CLI profile; actions run with the permissions of that profile. For HTTP mode, Oracle documents IDCS/IAM confidential-application settings and environment variables such as `IDCS_DOMAIN`, `IDCS_CLIENT_ID`, `IDCS_CLIENT_SECRET`, `IDCS_AUDIENCE`, `ORACLE_MCP_BASE_URL`, `ORACLE_MCP_HOST`, `ORACLE_MCP_PORT`, and `OCI_REGION`.
- Which transport should be used for this MCP server?
- Use STDIO with `uvx oracle.oci-cloud-guard-mcp-server` for a local MCP client backed by an OCI CLI profile. Use Streamable HTTP only when you need a locally hosted HTTP endpoint and have configured the required Oracle IAM confidential application and callback settings.