Skip to main content
The OCI Fusion Applications (FaaAS) MCP server provides tools for interacting with Oracle Cloud Infrastructure Fusion Applications as a Service via the OCI Python SDK.

Installation

uv run oracle.oci-faaas-mcp-server

Running the Server

uv run oracle.oci-faaas-mcp-server

Available Tools

The server provides the following tools for managing Fusion Applications:
Tool NameDescription
list_fusion_environment_familiesList Fusion Environment Families in a compartment
list_fusion_environmentsList Fusion Environments in a compartment (optionally by family)
get_fusion_environmentGet details of a Fusion Environment by OCID
get_fusion_environment_statusGet status of a Fusion Environment by OCID

Usage Examples

List Environment Families

List all Fusion Environment Families in my compartment
Retrieves all Fusion Environment Families with their configurations and states.

List Fusion Environments

List all Fusion Environments
Shows all Fusion Application environments across compartments.
List Fusion Environments in family ocid1.fusionenvironmentfamily.oc1..example
Filters environments by a specific family.

Get Environment Details

Get details for Fusion Environment ocid1.fusionenvironment.oc1..example
Retrieves comprehensive information about a specific Fusion Environment including:
  • Environment configuration
  • Application versions
  • Network settings
  • Domain information
  • Subscription details

Check Environment Status

What is the status of Fusion Environment ocid1.fusionenvironment.oc1..example?
Returns the current operational status and health of the environment.

Understanding Fusion Applications as a Service

What is FaaAS?

Oracle Fusion Applications as a Service (FaaAS) is Oracle’s cloud-based delivery of:
  • Oracle Fusion Applications - Complete suite of cloud applications
  • ERP (Enterprise Resource Planning)
  • HCM (Human Capital Management)
  • SCM (Supply Chain Management)
  • CX (Customer Experience)

Key Concepts

Fusion Environment Families
  • Logical grouping of related Fusion Environments
  • Share subscription and configuration
  • Enable environment lifecycle management
  • Support multiple environments (dev, test, prod)
Fusion Environments
  • Individual instances of Fusion Applications
  • Isolated and independent
  • Can be production or non-production
  • Include specific application modules
Environment Types
  • Production - Live business operations
  • Test - Testing and QA
  • Development - Development and customization
  • Sandbox - Training and experimentation

Features

Managed Service
  • Oracle manages infrastructure
  • Automatic updates and patches
  • High availability built-in
  • Disaster recovery included
Customization
  • Configuration without code
  • Extensibility through Oracle tools
  • Integration capabilities
  • Custom reports and workflows
Integration
  • Pre-built integrations
  • REST APIs
  • File-based integration
  • Event-driven architecture

Authentication

The server uses OCI CLI configuration from ~/.oci/config:
oci setup config

Required Permissions

Your OCI user or instance principal needs these IAM permissions: Read Fusion Environments:
Allow group FusionUsers to read fusion-apps-environment-family in compartment MyCompartment
Allow group FusionUsers to read fusion-apps-environment in compartment MyCompartment
Manage Fusion Environments:
Allow group FusionAdmins to manage fusion-apps-environment-family in compartment MyCompartment
Allow group FusionAdmins to manage fusion-apps-environment in compartment MyCompartment
Security NoticeAll actions are performed with the permissions of the configured OCI CLI profile. We advise:
  • Least-privilege IAM setup
  • Secure credential management
  • Safe network practices
  • Secure logging
  • Never expose secrets in logs or responses

Common Use Cases

Environment Management

  • Monitor Fusion Environment status
  • Track environment configurations
  • Manage multiple environments
  • Coordinate deployments

DevOps Integration

  • Automate environment provisioning
  • Integrate with CI/CD pipelines
  • Manage environment lifecycle
  • Coordinate releases

Monitoring & Operations

  • Check environment health
  • Monitor application status
  • Track environment changes
  • Troubleshoot issues

Governance & Compliance

  • Audit environment configurations
  • Track environment usage
  • Verify compliance settings
  • Document environment landscape

Best Practices

Environment Organization

  • Use clear naming conventions
  • Separate production and non-production
  • Group related environments in families
  • Document environment purposes

Monitoring

  • Regularly check environment status
  • Monitor application health
  • Track updates and patches
  • Review performance metrics

Security

  • Follow least-privilege access
  • Regular security reviews
  • Audit administrative actions
  • Protect integration credentials

Change Management

  • Test changes in non-production first
  • Document all customizations
  • Maintain configuration baselines
  • Plan and communicate changes

Integration Patterns

Application Integration

  • REST API integrations
  • File-based data exchange
  • Event-driven workflows
  • Real-time synchronization

Data Integration

  • ETL processes
  • Data warehousing
  • Analytics and reporting
  • Master data management

Process Automation

  • Workflow automation
  • Business process integration
  • Event triggers
  • Scheduled jobs

Notes

  • All list tools handle pagination automatically
  • Responses are converted to plain dictionaries using best-effort conversion of OCI SDK models
  • The server uses the OCI Python SDK oci.fusion_apps.FusionApplicationsClient

Troubleshooting

Environment Not Found

Check:
  • Environment OCID is correct
  • Environment is in expected compartment
  • You have permission to view environment
  • Environment exists in correct region

Permission Denied

  • Verify IAM policies include fusion-apps-environment permissions
  • Check compartment in policy matches resource compartment
  • Ensure using principal with appropriate access

Status Check Fails

  • Verify environment is running
  • Check network connectivity
  • Review environment health in console
  • Contact Oracle Support if persistent

Additional Resources

Build docs developers (and LLMs) love