From 757dfeaf8790d91e29475138531c2343ab309403 Mon Sep 17 00:00:00 2001
From: kriptoburak <kriptoburak@users.noreply.github.com>
Date: Mon, 20 Jul 2026 06:40:15 +0300
Subject: [PATCH] feat: add Xquik MCP manifest and align CI Python

Add the hosted Xquik MCP registry record with accurate proprietary licensing, authentication, runtime boundaries, and X Corp independence wording.

Run test and lint jobs on Python 3.11, matching the project minimum, and remove the workflow trailing whitespace.
---
 .github/workflows/test.yml      |   6 +-
 mcp-registry/servers/xquik.json | 104 ++++++++++++++++++++++++++++++++
 2 files changed, 107 insertions(+), 3 deletions(-)
 create mode 100644 mcp-registry/servers/xquik.json

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index e4874b3b..34c6571d 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -30,7 +30,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
+          python-version: '3.11'
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
@@ -47,7 +47,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
+          python-version: '3.11'
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
@@ -55,4 +55,4 @@ jobs:
       - name: Check code style with ruff
         run: |
           uv sync --group dev
-          uv run ruff check src/ tests/ 
\ No newline at end of file
+          uv run ruff check src/ tests/
diff --git a/mcp-registry/servers/xquik.json b/mcp-registry/servers/xquik.json
new file mode 100644
index 00000000..5f5b3231
--- /dev/null
+++ b/mcp-registry/servers/xquik.json
@@ -0,0 +1,104 @@
+{
+  "name": "xquik",
+  "display_name": "Xquik MCP Server",
+  "description": "Hosted MCP server for X data, search, user lookup, monitoring, webhooks, and write actions through the Xquik API. Xquik is an independent third-party service and is not affiliated with X Corp.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Xquik-dev/x-twitter-scraper"
+  },
+  "homepage": "https://docs.xquik.com/mcp/overview",
+  "author": {
+    "name": "Xquik-dev",
+    "url": "https://github.com/Xquik-dev"
+  },
+  "license": "Proprietary",
+  "categories": [
+    "Web Services",
+    "Analytics",
+    "Messaging"
+  ],
+  "tags": [
+    "x",
+    "twitter",
+    "social media",
+    "tweet search",
+    "user lookup",
+    "monitoring",
+    "webhooks",
+    "automation",
+    "remote mcp"
+  ],
+  "arguments": {
+    "XQUIK_API_KEY": {
+      "description": "Xquik API key from https://dashboard.xquik.com/en/account",
+      "required": true,
+      "example": "xq_your_api_key"
+    }
+  },
+  "installations": {
+    "http": {
+      "type": "http",
+      "url": "https://xquik.com/mcp",
+      "headers": {
+        "Authorization": "Bearer ${XQUIK_API_KEY}"
+      },
+      "description": "Connect to the hosted Xquik MCP server using Streamable HTTP.",
+      "recommended": true
+    }
+  },
+  "tools": [
+    {
+      "name": "explore",
+      "description": "Search the Xquik API catalog before making live API calls. Runs against an in-memory catalog only, does not make network calls, and is limited by a 60 second execution timeout. Runtime surface: standard JavaScript built-ins plus read-only spec.endpoints.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "JavaScript async arrow function for inputSchema.properties.code that filters the Xquik endpoint catalog. Available globals are standard JavaScript built-ins and spec.endpoints. No filesystem, process, import, credential, fetch, or outbound network access is available."
+          }
+        },
+        "required": [
+          "code"
+        ]
+      }
+    },
+    {
+      "name": "xquik",
+      "description": "Execute authenticated Xquik API calls for X/Twitter data, publishing, monitors, events, webhooks, and account workflows. Runs in a restricted server-side JavaScript runtime with a 60 second execution timeout. Runtime surface: standard JavaScript built-ins, spec.endpoints, and xquik.request. Network access is limited to Xquik API requests made through xquik.request.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "JavaScript async arrow function for inputSchema.properties.code that calls xquik.request(path, options). Authentication is injected by the server. Available globals are standard JavaScript built-ins, spec.endpoints, and xquik.request. Code cannot read credentials, access the filesystem or process, import modules, call fetch directly, or contact external hosts directly; only xquik.request can reach the Xquik API."
+          }
+        },
+        "required": [
+          "code"
+        ]
+      }
+    }
+  ],
+  "resources": [],
+  "prompts": [],
+  "examples": [
+    {
+      "title": "Search Tweets",
+      "description": "Find recent X posts that match a query.",
+      "prompt": "Use Xquik to search recent tweets about MCP registries."
+    },
+    {
+      "title": "Look Up A User",
+      "description": "Fetch normalized profile data for an X user.",
+      "prompt": "Use Xquik to look up the X profile for @xquik."
+    },
+    {
+      "title": "Monitor A Keyword",
+      "description": "Create an account or keyword monitor when the API key has access.",
+      "prompt": "Use Xquik to monitor new X posts mentioning my product keyword."
+    }
+  ],
+  "is_official": false,
+  "is_archived": false
+}