diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/ai-agents/cursor/_category_.json b/docs/build-your-software-catalog/sync-data-to-catalog/ai-agents/cursor/_category_.json
new file mode 100644
index 0000000000..5d78f0da1b
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/ai-agents/cursor/_category_.json
@@ -0,0 +1,5 @@
+{
+ "label": "Cursor",
+ "position": 18
+}
+
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/ai-agents/cursor/cursor.md b/docs/build-your-software-catalog/sync-data-to-catalog/ai-agents/cursor/cursor.md
new file mode 100644
index 0000000000..3a883b4b04
--- /dev/null
+++ b/docs/build-your-software-catalog/sync-data-to-catalog/ai-agents/cursor/cursor.md
@@ -0,0 +1,1472 @@
+import Tabs from "@theme/Tabs"
+import TabItem from "@theme/TabItem"
+import Prerequisites from "/docs/build-your-software-catalog/sync-data-to-catalog/templates/_ocean_helm_prerequisites_block.mdx"
+import AdvancedConfig from '/docs/generalTemplates/_ocean_advanced_configuration_note.md'
+import PortApiRegionTip from "/docs/generalTemplates/_port_region_parameter_explanation_template.md"
+
+# Cursor
+
+Port's Cursor integration allows you to ingest Cursor usage metrics into your software catalog using the [Ocean Custom Integration](/build-your-software-catalog/custom-integration/ocean-custom-integration/overview) framework.
+After installing this integration, you would be able to visualize your Cursor usage metrics using Port's dashboards.
+
+
+
+
+
+ Prerequisites
+
+ Installation
+
+1. Add Port's Helm repo and install the Ocean Custom Integration:
+
+:::note Replace placeholders
+Remember to replace the placeholders for `YOUR_PORT_CLIENT_ID`, `YOUR_PORT_CLIENT_SECRET`, and `YOUR_CURSOR_API_KEY`.
+:::
+
+```bash showLineNumbers
+helm repo add --force-update port-labs https://port-labs.github.io/helm-charts
+helm upgrade --install my-ocean-cursor-integration port-labs/port-ocean \
+ --set port.clientId="YOUR_PORT_CLIENT_ID" \
+ --set port.clientSecret="YOUR_PORT_CLIENT_SECRET" \
+ --set port.baseUrl="https://api.getport.io" \
+ --set initializePortResources=true \
+ --set scheduledResyncInterval=120 \
+ --set integration.identifier="my-ocean-cursor-integration" \
+ --set integration.type="custom" \
+ --set integration.eventListener.type="POLLING" \
+ --set integration.config.baseUrl="https://api.cursor.com" \
+ --set integration.config.authType="basic" \
+ --set integration.config.paginationType="none" \
+ --set integration.secrets.username="YOUR_CURSOR_API_KEY" \
+ --set integration.secrets.password=""
+```
+
+ Configuration parameters
+
+This table summarizes the available parameters for the installation.
+
+| Parameter | Description | Example | Required |
+|------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------|----------|
+| `port.clientId` | Your Port [client id](https://docs.port.io/build-your-software-catalog/custom-integration/api/#find-your-port-credentials) | | ✅ |
+| `port.clientSecret` | Your Port [client secret](https://docs.port.io/build-your-software-catalog/custom-integration/api/#find-your-port-credentials) | | ✅ |
+| `port.baseUrl` | Your Port API URL - `https://api.getport.io` for EU, `https://api.us.getport.io` for US | | ✅ |
+| `integration.config.baseUrl` | The base URL of the Cursor API instance | https://api.cursor.com | ✅ |
+| `integration.config.authType` | The authentication type for the API (use `basic` for Cursor) | basic | ✅ |
+| `integration.secrets.username` | Your Cursor API key (used as username in Basic Auth) | key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | ✅ |
+| `integration.secrets.password` | Password for Basic Auth (empty string for Cursor API) | "" | ✅ |
+| `integration.config.paginationType` | How your API handles pagination (offset, page, cursor, or none) | none | ❌ |
+| `integration.eventListener.type` | The event listener type. Read more about [event listeners](https://ocean.getport.io/framework/features/event-listener) | POLLING | ✅ |
+| `integration.type` | The integration type (must be `custom` for Ocean Custom Integration) | custom | ✅ |
+| `integration.identifier` | Unique identifier for the integration instance | my-ocean-cursor-integration | ✅ |
+| `scheduledResyncInterval` | The number of minutes between each resync. When not set the integration will resync for each event listener resync event. Read more about [scheduledResyncInterval](https://ocean.getport.io/develop-an-integration/integration-configuration/#scheduledresyncinterval---run-scheduled-resync) | 120 | ❌ |
+| `initializePortResources` | Default true, When set to true the integration will create default blueprints and the port App config Mapping. Read more about [initializePortResources](https://ocean.getport.io/develop-an-integration/integration-configuration/#initializeportresources---initialize-port-resources) | true | ❌ |
+| `sendRawDataExamples` | Enable sending raw data examples from the third party API to port for testing and managing the integration mapping. Default is true | true | ❌ |
+
+
+
+
+
+To run the integration using Docker for a one-time sync:
+
+:::note Replace placeholders
+Remember to replace the placeholders for `YOUR_PORT_CLIENT_ID`, `YOUR_PORT_CLIENT_SECRET`, and `YOUR_CURSOR_API_KEY`.
+:::
+
+```bash showLineNumbers
+docker run -i --rm --platform=linux/amd64 \
+ -e OCEAN__EVENT_LISTENER='{"type":"ONCE"}' \
+ -e OCEAN__INITIALIZE_PORT_RESOURCES=true \
+ -e OCEAN__SEND_RAW_DATA_EXAMPLES=true \
+ -e OCEAN__INTEGRATION__CONFIG__BASE_URL="https://api.cursor.com" \
+ -e OCEAN__INTEGRATION__CONFIG__AUTH_TYPE="basic" \
+ -e OCEAN__INTEGRATION__CONFIG__PAGINATION_TYPE="none" \
+ -e OCEAN__INTEGRATION__SECRETS__USERNAME="YOUR_CURSOR_API_KEY" \
+ -e OCEAN__INTEGRATION__SECRETS__PASSWORD="" \
+ -e OCEAN__PORT__CLIENT_ID="YOUR_PORT_CLIENT_ID" \
+ -e OCEAN__PORT__CLIENT_SECRET="YOUR_PORT_CLIENT_SECRET" \
+ -e OCEAN__PORT__BASE_URL="https://api.getport.io" \
+ ghcr.io/port-labs/port-ocean-custom:latest
+```
+
+
+
+
+
+
+## Set up data model
+
+Before the integration can sync data, you need to create the required blueprints in Port. These blueprints define the data model for your Cursor metrics.
+
+**To create the blueprints:**
+
+1. Go to your [Builder page](https://app.getport.io/settings/data-model).
+
+2. Click on the `+ Blueprint` button.
+
+3. Copy and paste each blueprint JSON from the sections below.
+
+
+ Cursor Usage Record Blueprint (Click to expand)
+
+
+ Cursor User Usage Record Blueprint (Click to expand)
+
+
+ Cursor Team Usage Record Blueprint (Click to expand)
+
+
+ Cursor Commit Record Blueprint (Click to expand)
+
+
+ Cursor Daily Commit Record Blueprint (Click to expand)
+
+
+ Cursor AI Code Change Record Blueprint (Click to expand)
+
+4. Click `Save` to save the blueprint.
+
+
+
+## Configuration
+
+After installation, define which endpoints to sync in your integration configuration. Each resource maps an API endpoint to Port entities using [JQ expressions](https://stedolan.github.io/jq/manual/) to transform the data.
+
+**Key mapping components:**
+- **`kind`**: The API endpoint path (combined with your base URL).
+- **`selector.query`**: JQ filter to include/exclude entities (use `'true'` to sync all).
+- **`selector.data_path`**: JQ expression pointing to the array of items in the response.
+- **`port.entity.mappings`**: How to map API fields to Port entity properties.
+
+For more details on how the Ocean Custom Integration works, see the [How it works](https://docs.port.io/build-your-software-catalog/custom-integration/ocean-custom-integration/overview#how-it-works) section in the custom integration overview.
+
+
+**To configure the mappings:**
+
+1. Go to your [data sources page](https://app.getport.io/settings/data-sources).
+
+2. Find your Cursor integration in the list.
+
+3. Click on the integration to open the mapping editor.
+
+4. Add the resource mapping configurations below.
+
+
+ Organization usage metrics mapping (Click to expand)
+
+
+ User-level usage events mapping (Click to expand)
+
+
+ Enterprise: Individual commit tracking (Click to expand)
+
+
+ Enterprise: AI code changes tracking (Click to expand)
+
+6. Click `Save` to save the mapping.
+
+
+
+## Customization
+
+If you want to customize your setup or test different API endpoints before committing to a configuration, use the [interactive builder](/build-your-software-catalog/custom-integration/ocean-custom-integration/build-your-integration).
+
+**The interactive builder helps you:**
+1. Test your Cursor API endpoints with live data.
+2. Automatically detect the data structure and field types.
+3. Generate blueprints and resource mappings tailored to your preferences.
+4. Get installation commands with your configuration pre-filled.
+
+Simply provide your Cursor API details, and the builder will generate everything you need to install and create the integration in Port.
+
+
+## Visualize Cursor metrics
+
+Once your Cursor data is synced to Port, you can create dashboards to monitor AI coding assistant usage, track adoption, analyze costs, and measure developer productivity. This section shows you how to build insightful visualizations using Port's dashboard widgets.
+
+ Total Active Users
+
+
+Total Active Users (click to expand)
+
+
+Total AI Accepts
+
+
+Total AI Accepts (click to expand)
+
+Total Cost
+
+
+Total Cost (click to expand)
+
+AI Suggestion Acceptance Rate Over Time
+
+
+AI Suggestion Acceptance Rate Over Time (click to expand)
+
+Daily Cost Trends
+
+
+Daily Cost Trends (click to expand)
+
+AI Code Generation Trends
+
+
+AI Code Generation Trends (click to expand)
+
+AI Model Usage Distribution
+
+
+AI Model Usage Distribution (click to expand)
+
+User Activity Breakdown
+
+
+User Activity Breakdown (click to expand)
+
+Daily Commit Activity
+
+
+Daily Commit Activity (click to expand)
diff --git a/src/components/IntegrationsTable/integrations-data.js b/src/components/IntegrationsTable/integrations-data.js
index 8aa07b0b0a..f9f35027f1 100644
--- a/src/components/IntegrationsTable/integrations-data.js
+++ b/src/components/IntegrationsTable/integrations-data.js
@@ -238,6 +238,13 @@ export const integrations = [
icon: '/img/guides/icons/GithubCopilot.svg',
darkIcon: '/img/guides/icons/dark/GithubCopilot.svg',
docsUrl: '/build-your-software-catalog/sync-data-to-catalog/ai-agents/github-copilot',
+ },
+ {
+ name: 'Cursor',
+ category: 'ai-agents',
+ icon: '/img/guides/icons/Cursor.svg',
+ darkIcon: '/img/guides/icons/dark/Cursor.svg',
+ docsUrl: '/build-your-software-catalog/sync-data-to-catalog/ai-agents/cursor',
}
];
diff --git a/static/img/ai-agents/cursorDashboard.png b/static/img/ai-agents/cursorDashboard.png
new file mode 100644
index 0000000000..e971a4bb34
Binary files /dev/null and b/static/img/ai-agents/cursorDashboard.png differ
diff --git a/static/img/ai-agents/cursorMetrics.png b/static/img/ai-agents/cursorMetrics.png
new file mode 100644
index 0000000000..e9864a47c1
Binary files /dev/null and b/static/img/ai-agents/cursorMetrics.png differ
diff --git a/static/img/guides/icons/Cursor.svg b/static/img/guides/icons/Cursor.svg
new file mode 100644
index 0000000000..a5b2ee3b1e
--- /dev/null
+++ b/static/img/guides/icons/Cursor.svg
@@ -0,0 +1 @@
+Cursor Cursor 
+
+
+## Supported metrics
+
+The Cursor integration can ingest usage metrics into Port. Available metrics depend on your Cursor subscription tier:
+
+**Available for all Cursor teams:**
+- `cursor_usage_record` - Organization-level daily usage metrics from `/teams/daily-usage-data`.
+
+**Requires Cursor Enterprise subscription:**
+- `cursor_commit_record` - Individual commits with AI assistance breakdown from `/analytics/ai-code/commits`.
+- `cursor_ai_code_change_record` - Daily AI-generated code changes from `/analytics/ai-code/changes`.
+
+:::info Cursor API availability
+The [Cursor API documentation](https://cursor.com/docs/api#available-apis) provides details on available endpoints. **Analytics APIs** (commit tracking and code changes) are only available for **Cursor Enterprise teams**. Standard Cursor teams can access usage metrics endpoints only.
+:::
+
+
+## Prerequisites
+
+To use this integration, you need:
+
+- A Cursor API token with appropriate permissions to access usage metrics.
+- The token should have read access to organization or team usage data.
+
+
+
+## Installation
+
+Choose one of the following installation methods to deploy the Ocean Custom Integration:
+
+
+
+### Create a dashboard
+
+1. Navigate to your [software catalog](https://app.getport.io/organization/catalog).
+
+2. Click on the **`+ New`** button in the left sidebar.
+
+3. Select **New dashboard**.
+
+4. Name the dashboard **Cursor AI Insights**.
+
+5. Input `Monitor Cursor AI usage, adoption, and productivity metrics` under **Description**.
+
+6. Select the `Cursor` icon.
+
+7. Click `Create`.
+
+You now have a blank dashboard where you can add widgets to visualize your Cursor metrics.
+
+### Add widgets
+
+Create the following widgets to gain insights into your Cursor usage:
+
+