Metadata-Version: 2.4
Name: oracle.oci-limits-mcp-server
Version: 1.0.3
Summary: OCI Limits MCP server
Author-email: Oracle MCP <237432095+oracle-mcp@users.noreply.github.com>
License-Expression: UPL-1.0
License-File: LICENSE.txt
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.13
Requires-Dist: fastmcp==3.2.4
Requires-Dist: oci==2.173.1
Description-Content-Type: text/markdown

# OCI Limits MCP Server

## Overview

This MCP server exposes Oracle Cloud Infrastructure Limits APIs through tools mirroring public endpoints.

## MCP client configuration (recommended)

Most users should configure their MCP client to launch the server, rather than starting it manually.

Add a stanza like this to your MCP client config (often called `mcp.json`; example shown is **stdio**):

```json
{
  "mcpServers": {
    "oci-limits": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "oracle.oci-limits-mcp-server"
      ],
      "env": {
        "OCI_CONFIG_PROFILE": "DEFAULT"
      }
    }
  }
}
```

## Tools

| Tool Name | Description | Parameters |
| --- | --- | --- |
| list_services | Returns supported services | compartment_id, sort_by='name', sort_order='ASC', limit=100, page=None, subscription_id=None |
| list_limit_definitions | Returns limit definitions | compartment_id, service_name=None, name=None, sort_by='name', sort_order='ASC', limit=100, page=None, subscription_id=None |
| list_limit_values | Returns limit values | compartment_id, service_name, scope_type=None, availability_domain=None, name=None, sort_by='name', sort_order='ASC', limit=100, page=None, subscription_id=None, external_location=None |
| get_resource_availability | Returns usage/availability for a specific limit | service_name, limit_name, compartment_id, availability_domain=None, subscription_id=None, external_location=None |

## Authentication

Follows the same pattern as other OCI MCP servers:
- Reads OCI config from ~/.oci/config
- Uses security token authentication
- Adds custom user agent header

## Notes

- For AD-scoped limits, `availability_domain` is required.
- Tools return dicts aligned with Swagger models.

## License

Copyright (c) 2025 Oracle and/or its affiliates.
Released under the Universal Permissive License v1.0.

## Third-Party APIs

Developers distributing binary implementations must obtain and provide required third-party licenses and copyright notices.

## Disclaimer

Users are responsible for local environment and credential safety. Different language models may yield different results.
