Skip to content

Add Xquik MCP workflow rule and repair MCP frontmatter - #317

Open
kriptoburak wants to merge 1 commit into
PatrickJS:mainfrom
kriptoburak:codex/add-xquik-mcp-rule
Open

Add Xquik MCP workflow rule and repair MCP frontmatter#317
kriptoburak wants to merge 1 commit into
PatrickJS:mainfrom
kriptoburak:codex/add-xquik-mcp-rule

Conversation

@kriptoburak

@kriptoburak kriptoburak commented Jun 20, 2026

Copy link
Copy Markdown

Summary

Adds a Cursor Project Rule for using Xquik through MCP. The rule covers current X research, exports, monitoring, and explicit connected-account workflows. It uses Cursor's native OAuth 2.1 flow and keeps mutations user-directed.

Also fixes invalid YAML frontmatter in the existing Helium MCP rule.

Contribution Type

  • New Cursor rule file or rules folder
  • Update/fix to an existing rule
  • New rules/*.mdc rule
  • Documentation or README cleanup

Value To Cursor Users

Cursor users get a reusable, OAuth-first rule for discovering and executing Xquik operations without inventing live X data. The rule explains narrow reads, pagination, mutation boundaries, secret handling, errors, and evidence-based responses.

The Helium fix preserves its intended universal scope while making its frontmatter valid YAML.

Added Or Changed Files

  • rules/xquik-mcp-x-research.mdc: Adds the complete Xquik MCP workflow rule.
  • rules/helium-mcp-cursorrules-prompt-file.mdc: Quotes its wildcard glob so YAML parsers can read the frontmatter.
  • README.md: Registers the Xquik rule under Database and API.

Quality Checklist

  • The contribution includes original rule content, or clearly credits the source.
  • New rule files use a descriptive kebab-case filename, such as react-typescript.mdc.
  • New rules/*.mdc files include frontmatter with a non-empty description, relevant globs, and alwaysApply: false unless the rule is universal.
  • README links use canonical GitHub URLs for repo files and point to the correct category.
  • The text is neutral and useful, not sales copy.
  • This is not a standalone external tool, product, directory, marketplace, or service listing.
  • No secrets, credentials, affiliate links, tracking links, or unrelated product claims are included.
  • I checked for duplicate or near-duplicate existing entries.

Notes For Maintainers

The connection flow and tool behavior were verified against the current public Xquik MCP documentation and discovery contracts. The rule directs Cursor to the live tool list when the contract changes.

The independent Helium defect is reproduced in #344.

Fixes #344.

Validation:

  • npm test (84 tests)
  • npm run check:awesome-list
  • npm run check:repo-hygiene
  • npm run check:readme-hygiene
  • npm run check:rule-hygiene
  • npm run check:issue-template-policy
  • npm run check:repo-security
  • YAML parsing for both changed rule frontmatters
  • git diff --check

Summary by CodeRabbit

  • Documentation
    • Added an “Xquik MCP X Research” entry to the README’s Database and API section.
    • Introduced a new Cursor MCP rule for X/Twitter research via the Xquik Streamable HTTP server, including OAuth login, read-only guidance, pagination handling, and clearer result formatting expectations.
  • Bug Fix
    • Improved Cursor rule file-matching consistency by updating the glob pattern quoting.

@coderabbitai

coderabbitai Bot commented Jun 20, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 7381846f-0c30-414d-bf9b-2615b34f8a57

📥 Commits

Reviewing files that changed from the base of the PR and between 106e5a4 and 7525f40.

📒 Files selected for processing (3)
  • README.md
  • rules/helium-mcp-cursorrules-prompt-file.mdc
  • rules/xquik-mcp-x-research.mdc
🚧 Files skipped from review as they are similar to previous changes (1)
  • README.md

📝 Walkthrough

Walkthrough

Adds a Cursor rule for configuring and using Xquik’s remote MCP server for public X research and explicitly requested account workflows, registers it in the README, and quotes a glob pattern in another Cursor rule.

Changes

Xquik MCP X Research Rule and Registration

Layer / File(s) Summary
Xquik MCP rule behavior and setup
rules/xquik-mcp-x-research.mdc
Defines Xquik MCP setup, authentication guidance, explore-first tool selection, request and mutation constraints, error handling, and response formatting.
README registration
README.md
Adds the Xquik MCP research rule under the Database and API section.

Cursor Rule Metadata

Layer / File(s) Summary
Quoted glob configuration
rules/helium-mcp-cursorrules-prompt-file.mdc
Changes the Cursor rule glob metadata from **/* to '**/*'.

Estimated code review effort: 2 (Simple) | ~10 minutes

Suggested reviewers: patrickjs

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Out of Scope Changes check ⚠️ Warning The Xquik rule and README entry are unrelated to linked issue #344, which only asked for the Helium glob fix. Limit the PR to the Helium frontmatter change for #344, or link the Xquik rule and README updates to their own issue.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly describes the main changes: adding an Xquik MCP workflow rule and fixing MCP frontmatter.
Description check ✅ Passed The description matches the template well and includes summary, contribution type, value, files, checklist, and maintainer notes.
Linked Issues check ✅ Passed The Helium glob fix satisfies #344 by quoting the universal glob so the frontmatter parses correctly.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@rules/xquik-mcp-x-research.mdc`:
- Line 3: The glob pattern `globs: **/*` on line 3 is invalid YAML because the
`**` sequence is interpreted as an alias indicator, and the pattern is too broad
as it matches every file in every directory. Fix this by either properly quoting
the pattern as `'**/*'` if a universal pattern is truly needed, or better yet,
narrow it to specific file extensions relevant to the X/Twitter research rule
following the repository's documented format (e.g., patterns like **/*.ts,
**/*.tsx for TypeScript files). Refer to the repository's README for the correct
documented format for glob patterns in this rule file.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 4ab986fc-f791-4b8b-8a39-0bff64e6a33c

📥 Commits

Reviewing files that changed from the base of the PR and between b044f95 and 8f7bfb9.

📒 Files selected for processing (2)
  • README.md
  • rules/xquik-mcp-x-research.mdc

Comment thread rules/xquik-mcp-x-research.mdc Outdated
@kriptoburak

kriptoburak commented Jun 20, 2026

Copy link
Copy Markdown
Author

Rebuilt the focused 3-file change on the current main as 1 GitHub-verified signed commit: 7525f40.

The independent fix remains linked to #344. It quotes the Helium MCP rule glob so its YAML frontmatter parses without changing its intended scope.

Validation rerun on the exact submitted tree:

  • npm test (84/84)
  • npm run check:awesome-list
  • npm run check:repo-hygiene
  • npm run check:readme-hygiene
  • npm run check:rule-hygiene
  • npm run check:issue-template-policy
  • npm run check:repo-security
  • git diff --check

All repository checks pass. The earlier CodeRabbit thread remains resolved.
The latest CodeRabbit review is also addressed: pagination now uses each
operation's documented cursor query, and X writes require connected-account
confirmation. Both new threads are resolved.

@kriptoburak kriptoburak changed the title Add Xquik MCP Cursor rule Add Xquik MCP workflow rule and repair MCP frontmatter Jul 29, 2026
@kriptoburak
kriptoburak force-pushed the codex/add-xquik-mcp-rule branch from 0d83a00 to 106e5a4 Compare July 30, 2026 17:04

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@rules/xquik-mcp-x-research.mdc`:
- Line 36: Update the mutation-confirmation instruction in the rules content to
require confirming the authenticated connected-account identity alongside the
target and payload before any X write, including publishing, deleting,
following, messaging, or account-state changes.
- Line 35: Clarify the Xquik pagination guidance in the rule containing
“has_more” and “next_cursor”: pagination is response-driven and
endpoint-specific, so pass “next_cursor” using “cursor” for X data
search/timelines, “after” for extractions/events/radar/draws, or “afterCursor”
for drafts while preserving existing filters and limits. Update the guidance
around the scoped request options to pass “method”, “query”, and “body” whenever
the discovered endpoint requires them or the task needs date windows, filters,
limits, or mutation payloads.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 342c5171-1c1f-4807-aab1-8c23190e7b34

📥 Commits

Reviewing files that changed from the base of the PR and between 0d83a00 and 106e5a4.

📒 Files selected for processing (3)
  • README.md
  • rules/helium-mcp-cursorrules-prompt-file.mdc
  • rules/xquik-mcp-x-research.mdc
🚧 Files skipped from review as they are similar to previous changes (1)
  • README.md

Comment thread rules/xquik-mcp-x-research.mdc Outdated
Comment thread rules/xquik-mcp-x-research.mdc Outdated
@kriptoburak
kriptoburak force-pushed the codex/add-xquik-mcp-rule branch from 106e5a4 to 7525f40 Compare July 30, 2026 17:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Quote the Helium MCP glob so its frontmatter parses

1 participant