diff --git a/.github/workflows/context7-refresh.yml b/.github/workflows/context7-refresh.yml
new file mode 100644
index 0000000..e29d5f0
--- /dev/null
+++ b/.github/workflows/context7-refresh.yml
@@ -0,0 +1,21 @@
+name: Refresh Context7
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  refresh:
+    name: Refresh Context7 docs
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Trigger Context7 refresh
+        run: |
+          curl -fsS -X POST https://context7.com/api/v1/refresh \
+            -H "Content-Type: application/json" \
+            -H "Authorization: Bearer ${{ secrets.CONTEXT7_API_KEY }}" \
+            -d '{"libraryName": "/${{ github.repository }}"}'
diff --git a/context7.json b/context7.json
index 421f04c..bd6fd4d 100644
--- a/context7.json
+++ b/context7.json
@@ -1,4 +1,18 @@
 {
+  "$schema": "https://context7.com/schema/context7.json",
   "url": "https://context7.com/sumup-oss/markdown-annotatedstring",
-  "public_key": "pk_O90Fl2BsRFDaLDD9XYqQi"
+  "public_key": "pk_O90Fl2BsRFDaLDD9XYqQi",
+  "projectTitle": "Markdown to AnnotatedString Generator",
+  "description": "Lightweight Android library that converts Markdown into one Jetpack Compose AnnotatedString for a Text. minSdk 24.",
+  "excludeFiles": [
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "CODE_OF_CONDUCT.md",
+    "SECURITY.md"
+  ],
+  "rules": [
+    "Depend on com.sumup.markdown:annotatedstring-generator:0.1.1.",
+    "Render the result as one AnnotatedString inside a Compose Text.",
+    "Read link targets from the URL string annotation."
+  ]
 }