get_organization_entitlements
Retrieve organization subscription details and feature limits from Terraform Cloud to understand available capabilities and entitlements.
Instructions
Show entitlement set for organization features
Retrieves information about available features and capabilities based on the organization's subscription tier.
API endpoint: GET /organizations/{organization}/entitlement-set
Args: organization: The organization name to retrieve entitlements for (required)
Returns: Entitlement set details including feature limits and subscription information
See: docs/tools/organization.md for reference documentation
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| organization | Yes |
Implementation Reference
- The handler function that executes the tool logic by creating a request model and calling the Terraform Cloud API to fetch organization entitlements.
@handle_api_errors async def get_organization_entitlements(organization: str) -> APIResponse: """Show entitlement set for organization features Retrieves information about available features and capabilities based on the organization's subscription tier. API endpoint: GET /organizations/{organization}/entitlement-set Args: organization: The organization name to retrieve entitlements for (required) Returns: Entitlement set details including feature limits and subscription information See: docs/tools/organization.md for reference documentation """ request = OrganizationEntitlementsRequest(organization=organization) return await api_request(f"organizations/{request.organization}/entitlement-set") - Pydantic schema/model for input validation of the organization parameter used in the tool.
class OrganizationEntitlementsRequest(APIRequest): """Request model for getting organization entitlements. This model is used for the GET /organizations/{name}/entitlement-set endpoint. The endpoint returns information about which features and capabilities are available to the organization based on its subscription tier. Reference: https://developer.hashicorp.com/terraform/cloud-docs/api-docs/organizations#show-the-entitlement-set See: docs/models/organization.md for reference """ organization: str = Field( ..., # No alias needed as field name matches API field name description="The name of the organization to retrieve entitlements for", min_length=3, pattern=r"^[a-z0-9][-a-z0-9_]*[a-z0-9]$", ) - terraform_cloud_mcp/server.py:76-76 (registration)MCP tool registration of the get_organization_entitlements handler function.
mcp.tool()(organizations.get_organization_entitlements)