Integrate Limits MCP server #36

mayurkhandave · 2025-10-15T22:06:58Z

Description

Integrating Limits MCP server to support fetching limit value and usage

Fixes # 34

Type of change

New feature (non-breaking change which adds functionality)
This change requires a documentation update

How Has This Been Tested?

Unit tests
Integrated locally with cline and tested following prompts
- what is my usage for standard-e2-core-count for ocid1.tenancy.oc1..xyz
- list all limit services

Checklist:

My code follows the style guidelines of this project
I have performed a self-review of my own code
I have commented my code, particularly in hard-to-understand areas
I have made corresponding changes to the documentation
My changes generate no new warnings
I have added tests that prove my fix is effective or that my feature works
New and existing unit tests pass locally with my changes
Any dependent changes have been merged and published in downstream modules

oracle-contributor-agreement · 2025-10-15T22:07:03Z

Thank you for your pull request and welcome to our community! To contribute, please sign the Oracle Contributor Agreement (OCA).
The following contributors of this PR have not signed the OCA:

mayur.khandave@oacle.com

To sign the OCA, please create an Oracle account and sign the OCA in Oracle's Contributor Agreement Application.

When signing the OCA, please provide your GitHub username. After signing the OCA and getting an OCA approval from Oracle, this PR will be automatically updated.

If you are an Oracle employee, please make sure that you are a member of the main Oracle GitHub organization, and your membership in this organization is public.

shopewf · 2025-10-17T17:06:21Z

src/oci-limits-mcp-server/oracle/oci_limits_mcp_server/server.py

+    subscription_id: Annotated[Optional[str], "Subscription OCID filter"] = None,
+) -> list[dict]:
+    """
+    Maps to GET /20190729/services/{serviceName}/limits/{limitName}/resourceAvailability


The @mcp.tool description will overwrite this btw

More like a comment

Signed-off-by: Mayur Khandave <mayur.khandave@oracle.com>

Signed-off-by: Richard Gebhardt <richard.gebhardt@oracle.com>

Signed-off-by: Mayur Khandave <mayur.khandave@oracle.com>

Signed-off-by: will.shope <will.shope@oracle.com>

gebhardtr · 2025-10-22T19:25:44Z

src/oci-limits-mcp-server/pyproject.toml

+    "fastmcp==2.12.2",
+    "oci==2.160.0"
+]
+


can you add an authors attribute? feel free to use our project address: https://github.com/oracle/mcp/blob/main/src/oci-api-mcp-server/pyproject.toml#L9-L11; we'll create issues and assign them if ppl contact us.

Other than that, LGTM.

shopewf · 2025-10-29T19:25:00Z

src/oci-limits-mcp-server/oracle/oci_limits_mcp_server/server.py

+    return oci.limits.LimitsClient(config, signer=signer)
+
+
+def get_identity_client():


Should we be getting identity client here? I think we would want to leave the calls for this to the identity server, no?

I tried approach of letting cline decide if call to availability domain is needed and then figure out calling identity mcp

but it was very slow and most of the time it was not able to find it

shopewf · 2025-10-29T19:25:49Z

src/oci-limits-mcp-server/oracle/oci_limits_mcp_server/server.py

+
+
+# ----------------------------
+# Mappers to stable dict shapes


Put these mappers into a models.py file? Check the standards we're laying out in this PR
#43

shopewf · 2025-10-29T19:26:26Z

src/oci-limits-mcp-server/oracle/oci_limits_mcp_server/server.py

+@mcp.tool(
+    description="List availability domains for a given compartment needed for limits"
+)
+def provide_availability_domains_for_limits(


This is already a tool in our identity server, if it needs to be used Id rather have some other annotation that tells another tool that it would need to consume the list_availabilty_domains tool in some cases

shopewf · 2025-10-29T19:28:02Z

src/oci-limits-mcp-server/oracle/oci_limits_mcp_server/server.py

+)
+def list_services(
+    compartment_id: Annotated[str, "OCID of the root compartment (tenancy)"],
+    sort_by: Annotated[str, "Sort field: name or description"] = "name",


Check best practices PR to see how best to annotate and define optional parameters
#43

shopewf · 2025-10-29T19:30:01Z

src/oci-limits-mcp-server/oracle/oci_limits_mcp_server/server.py

+@mcp.tool(
+    description="Get the full list of resource limit values for the given service"
+)
+def get_limit_value(


Name should be list_limit_values rather than get_limit_value, no? Name is super important for LLMs to determine which tool to call

shopewf · 2025-10-29T19:30:54Z

src/oci-limits-mcp-server/oracle/oci_limits_mcp_server/server.py

+    """
+    try:
+        client = get_limits_client()
+        items = list_limit_values_with_pagination(


I did this same thing in some of my earlier PRs where I split things up into a utils function, but we decided as a team to try and keep relevant code near each other. Could we just take the contents of this help file and stick them here?

Edit: I see this function gets reused below, hmmm....

gebhardtr · 2025-10-30T00:26:06Z

Closes #36

oracle-contributor-agreement bot added the OCA Required At least one contributor does not have an approved Oracle Contributor Agreement. label Oct 15, 2025

mayurkhandave force-pushed the 34-fixes branch from 0f384f3 to 1dee121 Compare October 17, 2025 16:34

shopewf reviewed Oct 17, 2025

View reviewed changes

mayurkhandave and others added 9 commits October 20, 2025 09:11

Integrate Limits MCP server

e7b050a

Signed-off-by: Mayur Khandave <mayur.khandave@oracle.com>

Fix Lint issues

26a91ee

Signed-off-by: Mayur Khandave <mayur.khandave@oracle.com>

Fix Lint issues

29cb609

Signed-off-by: Mayur Khandave <mayur.khandave@oracle.com>

chore: release 1.0.1 (oracle#33)

09c310b

Signed-off-by: Richard Gebhardt <richard.gebhardt@oracle.com>

Fix Lint issues

909c145

Signed-off-by: Mayur Khandave <mayur.khandave@oracle.com>

Fix Lint issues

c4f46d8

Signed-off-by: Mayur Khandave <mayur.khandave@oracle.com>

Fix Lint issues

b160c88

Signed-off-by: Mayur Khandave <mayur.khandave@oracle.com>

Fix Lint issues

a900f76

Signed-off-by: Mayur Khandave <mayur.khandave@oracle.com>

[CHORE] Update readme for PyPi packages (oracle#32)

fedf1e2

Signed-off-by: will.shope <will.shope@oracle.com>

mayurkhandave force-pushed the 34-fixes branch from 8701c7a to fedf1e2 Compare October 20, 2025 16:13

oracle-contributor-agreement bot added OCA Verified All contributors have signed the Oracle Contributor Agreement. and removed OCA Required At least one contributor does not have an approved Oracle Contributor Agreement. labels Oct 20, 2025

Merge branch 'oracle:main' into 34-fixes

7063bbd

gebhardtr reviewed Oct 22, 2025

View reviewed changes

Merge branch 'oracle:main' into 34-fixes

4b38746

shopewf reviewed Oct 29, 2025

View reviewed changes

Add Author details

e2831a5

		return oci.limits.LimitsClient(config, signer=signer)


		def get_identity_client():



		# ----------------------------
		# Mappers to stable dict shapes

Integrate Limits MCP server #36

Are you sure you want to change the base?

Integrate Limits MCP server #36

Uh oh!

Conversation

mayurkhandave commented Oct 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Type of change

How Has This Been Tested?

Checklist:

Uh oh!

oracle-contributor-agreement bot commented Oct 15, 2025

Uh oh!

shopewf Oct 17, 2025

Choose a reason for hiding this comment

Uh oh!

mayurkhandave Oct 17, 2025

Choose a reason for hiding this comment

Uh oh!

gebhardtr Oct 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mayurkhandave Oct 29, 2025

Choose a reason for hiding this comment

Uh oh!

shopewf Oct 29, 2025

Choose a reason for hiding this comment

Uh oh!

mayurkhandave Oct 29, 2025

Choose a reason for hiding this comment

Uh oh!

shopewf Oct 29, 2025

Choose a reason for hiding this comment

Uh oh!

shopewf Oct 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

shopewf Oct 29, 2025

Choose a reason for hiding this comment

Uh oh!

shopewf Oct 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

shopewf Oct 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

gebhardtr commented Oct 30, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

mayurkhandave commented Oct 15, 2025 •

edited

Loading

gebhardtr Oct 22, 2025 •

edited

Loading

shopewf Oct 29, 2025 •

edited

Loading

shopewf Oct 29, 2025 •

edited

Loading

shopewf Oct 29, 2025 •

edited

Loading