Expand Paperclip Mintlify docs with tools, routes, and credentials.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: lanbytes

changelog.mdx

@@ -3,6 +3,11 @@ title: "Changelog"
 description: "Docs repository changes for the TwexAPI Mintlify site."
 ---
 
+## 2026-08-25
+
+- Added Paperclip plugin docs with install, configuration, credentials, routes, and npm pin guidance.
+- Linked `@twexapi/paperclip-plugin-x-api-scraper` in the SDK index.
+
 ## 2026-08-24
 
 - First public docs repository aligned with the 66-operation SDK OpenAPI.

sdks/paperclip.mdx

@@ -9,6 +9,27 @@ Install `@twexapi/paperclip-plugin-x-api-scraper` in Paperclip. The plugin reads
 paperclipai plugin install @twexapi/paperclip-plugin-x-api-scraper
 ```
 
+Pin the current release when you need reproducible installs:
+
+```bash
+paperclipai plugin install @twexapi/paperclip-plugin-x-api-scraper --version 0.1.0
+```
+
+npm: [@twexapi/paperclip-plugin-x-api-scraper](https://www.npmjs.com/package/@twexapi/paperclip-plugin-x-api-scraper)
+
+## Tools
+
+| Agent task | Paperclip tool | Result |
+| --- | --- | --- |
+| Search tweets | `twexapi.search_tweets` | Run a Twitter search with query operators. |
+| Read one tweet | `twexapi.lookup_tweet` | Get a tweet by ID. |
+| Find X users | `twexapi.search_users` | Search by name or username. |
+| Read a profile | `twexapi.get_user` | Get public profile data. |
+| Read profile tweets | `twexapi.get_user_tweets` | List recent posts from one user. |
+| Read trending tweets | `twexapi.get_trends` | Get trending tweets by country. |
+
+## TwexAPI routes
+
 | Agent task | Paperclip tool | TwexAPI route |
 | --- | --- | --- |
 | Search tweets | `twexapi.search_tweets` | `POST /twitter/advanced_search/page` |
@@ -18,6 +39,25 @@ paperclipai plugin install @twexapi/paperclip-plugin-x-api-scraper
 | Read profile tweets | `twexapi.get_user_tweets` | `POST /twitter/{screen_name}/timeline/page` |
 | Read trending tweets | `twexapi.get_trends` | `GET /twitter/global-trending/tweets` |
 
+## Configuration
+
+- `apiBaseUrl`: TwexAPI REST endpoint. Defaults to `https://api.twexapi.io`.
+- `apiKeySecretRef`: Paperclip secret reference for the TwexAPI API key.
+- `defaultTimelineCount`: Default timeline page count from 1 to 100.
+- `defaultUserSearchCount`: Default user search count from 1 to 100.
+- `defaultTrendCount`: Default trend count from 1 to 100.
+
+## Credentials
+
+Create an API key in the [TwexAPI dashboard](https://twexapi.io/dashboard) and store it in a Paperclip secret referenced by `apiKeySecretRef`.
+
 The plugin is read-only. Use REST or an SDK for follower pagination and approved posting.
 
+## Resources
+
+- [OpenAPI schema](https://docs.twexapi.io/openapi.json)
+- [API reference](/api-reference/overview)
+- [Paperclip plugin source](https://github.com/twexapi-dev/paperclip-plugin-x-api-scraper)
+- [TwexAPI dashboard](https://twexapi.io/dashboard)
+
 Source: [paperclip-plugin-x-api-scraper](https://github.com/twexapi-dev/paperclip-plugin-x-api-scraper)