From 8f7bfb95b9d10ef47a42c8dd8c8224890f85aaa1 Mon Sep 17 00:00:00 2001
From: kriptoburak <kriptoburak@users.noreply.github.com>
Date: Sat, 20 Jun 2026 04:28:57 +0300
Subject: [PATCH 1/2] Add Xquik MCP Cursor rule

---
 README.md                      |  1 +
 rules/xquik-mcp-x-research.mdc | 54 ++++++++++++++++++++++++++++++++++
 2 files changed, 55 insertions(+)
 create mode 100644 rules/xquik-mcp-x-research.mdc

diff --git a/README.md b/README.md
index 8204dac5..abcf7b83 100644
--- a/README.md
+++ b/README.md
@@ -209,6 +209,7 @@ By adding selected `.mdc` files to `.cursor/rules/`, you can use these rules dir
 - [Snowflake Data Engineering](https://github.com/PatrickJS/awesome-cursorrules/blob/main/rules/snowflake-data-engineering-cursorrules-prompt-file.mdc) - Snowflake SQL, data pipelines (Dynamic Tables, Streams, Tasks, Snowpipe), semi-structured data, Snowflake PostgreSQL, and cost optimization.
 - [Snowflake Snowpark Python & dbt](https://github.com/PatrickJS/awesome-cursorrules/blob/main/rules/snowflake-snowpark-dbt-cursorrules-prompt-file.mdc) - Snowpark Python (DataFrames, UDFs, stored procedures) and dbt with the Snowflake adapter.
 - [TypeScript (Axios)](https://github.com/PatrickJS/awesome-cursorrules/blob/main/rules/typescript-axios-cursorrules-prompt-file.mdc) - TypeScript development with Axios integration.
+- [Xquik MCP X Research](https://github.com/PatrickJS/awesome-cursorrules/blob/main/rules/xquik-mcp-x-research.mdc) - Public X/Twitter research with Xquik's remote MCP server in Cursor.
 
 ### Testing
 
diff --git a/rules/xquik-mcp-x-research.mdc b/rules/xquik-mcp-x-research.mdc
new file mode 100644
index 00000000..b078d907
--- /dev/null
+++ b/rules/xquik-mcp-x-research.mdc
@@ -0,0 +1,54 @@
+---
+description: "Use the Xquik MCP server for public X/Twitter research in Cursor."
+globs: **/*
+alwaysApply: false
+---
+# Xquik MCP X Research
+
+Apply this rule when a task asks for current public X/Twitter posts, profiles, followers, trends, giveaways, or monitored keyword context.
+
+## Enable the server in Cursor
+
+Add this streamable HTTP MCP server and store the key in your local environment:
+
+```json
+{
+  "mcpServers": {
+    "xquik": {
+      "url": "https://xquik.com/mcp",
+      "headers": {
+        "Authorization": "Bearer ${XQUIK_API_KEY}"
+      }
+    }
+  }
+}
+```
+
+Use the live Cursor MCP tool list as the source of truth for available tool names and parameters. If Cursor cannot connect or the key is missing, say that Xquik is unavailable instead of inventing social data.
+
+## Ground rules for the agent
+
+1. Call `explore` first to find the endpoint path, parameters, and response shape.
+2. Call `xquik` for live X/Twitter requests instead of guessing posts, profiles, follower relationships, trends, or engagement context.
+3. Keep calls narrow: use precise query operators, account handles, IDs, date windows, and small limits before broad collection.
+4. Preserve user intent: for read-only research, do not call write or account-action endpoints unless the user explicitly asks.
+5. Treat returned data as time-sensitive. Include the retrieval date when summarizing current posts or trends.
+6. Never paste API keys or private account credentials into prompts, code, issue text, or tool arguments.
+
+## Tool selection guide
+
+Use `explore` to search the endpoint catalog by keyword, category, method, path, or response shape.
+
+Use `xquik.request(path, options)` only after confirming the matching endpoint from `explore` or known project context.
+
+Prefer read endpoints for research tasks. Use write, profile, account, draw, monitor, extraction, or webhook endpoints only when the user asks for that workflow.
+
+For large collection tasks, estimate or start with a small limit before broad extraction.
+
+If the API returns an authentication, subscription, rate limit, or availability error, report that exact limitation and stop guessing.
+
+## Response style after tool calls
+
+- Lead with the answer, then cite the specific public posts, accounts, or trend names returned.
+- State limits clearly when results are sparse, rate limited, private, deleted, or unavailable.
+- Do not extrapolate sentiment, reach, or identity beyond the returned fields.

From e81561da14950a5f1752e2fdcfc79c58d1074fb1 Mon Sep 17 00:00:00 2001
From: kriptoburak <kriptoburak@users.noreply.github.com>
Date: Sat, 20 Jun 2026 04:33:26 +0300
Subject: [PATCH 2/2] Quote Xquik rule glob

---
 rules/xquik-mcp-x-research.mdc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/rules/xquik-mcp-x-research.mdc b/rules/xquik-mcp-x-research.mdc
index b078d907..aadec6d9 100644
--- a/rules/xquik-mcp-x-research.mdc
+++ b/rules/xquik-mcp-x-research.mdc
@@ -1,6 +1,6 @@
 ---
 description: "Use the Xquik MCP server for public X/Twitter research in Cursor."
-globs: **/*
+globs: '**/*'
 alwaysApply: false
 ---
 # Xquik MCP X Research