Add AI & LLM resources page

Author: tcaldwell-x

docs.json

@@ -23,7 +23,30 @@
                   "developer-guidelines",
                   "what-to-build",
                   "make-your-first-request",
-                  "tools-and-libraries"
+                  {
+                    "group": "Tools & Libraries",
+                    "icon": "toolbox",
+                    "pages": [
+                      "tools-and-libraries",
+                      "tools/xurl",
+                      {
+                        "group": "SDKs (XDKs)",
+                        "pages": [
+                          "tools/python-xdk",
+                          "tools/typescript-xdk"
+                        ]
+                      },
+                      {
+                        "group": "AI & LLM Resources",
+                        "pages": [
+                          "tools/ai-docs",
+                          "tools/llms-txt",
+                          "tools/skill-md",
+                          "tools/mcp"
+                        ]
+                      }
+                    ]
+                  }
                 ]
               },
               {
@@ -1071,7 +1094,7 @@
             ]
           },
           {
-            "tab": "Python SDK",
+            "tab": "Python XDK",
             "hidden": true,
             "pages": [
               "xdks/python/overview",
@@ -1464,7 +1487,7 @@
             ]
           },
           {
-            "tab": "TypeScript SDK",
+            "tab": "TypeScript XDK",
             "hidden": true,
             "pages": [
               "xdks/typescript/overview",

overview.mdx

@@ -83,8 +83,8 @@ Earn free [xAI API](https://docs.x.ai) credits when you purchase X API credits 
   <Card title="Developer Forum" icon="comments" href="https://devcommunity.x.com">
     Get help from the community and X team.
   </Card>
-  <Card title="Changelog" icon="clock-rotate-left" href="/changelog">
-    Stay updated on API changes and new features.
+  <Card title="AI & LLM Resources" icon="sparkles" href="/tools/ai-docs">
+    llms.txt, skill.md, MCP servers, and resources for AI-powered development.
   </Card>
 </CardGroup>
 

tools-and-libraries.mdx

@@ -1,20 +1,18 @@
 ---
 title: Tools & Libraries
-icon: toolbox
-description: Official SDKs, community libraries, and developer tools for the X API
-keywords: ["tools", "libraries", "SDK", "XDK", "client libraries", "Postman", "xurl", "developer tools", "API tools", "code libraries", "Python SDK", "TypeScript SDK"]
+sidebarTitle: Overview
+description: Official SDKs, developer tools, AI integrations, and community libraries for the X API
+keywords: ["tools", "libraries", "SDK", "XDK", "client libraries", "Postman", "xurl", "playground", "XMCP", "developer tools", "API tools", "code libraries", "Python SDK", "TypeScript SDK", "AI tools", "MCP"]
 ---
 
 import { Button } from '/snippets/button.mdx';
 
-Speed up your development with official SDKs, community libraries, and developer tools.
+Speed up your development with official SDKs, developer tools, and community libraries.
 
 ---
 
 ## Official SDKs
 
-X provides official SDKs for TypeScript and Python with full X API v2 support.
-
 <CardGroup cols={2}>
   <Card title="Python SDK" icon="python" href="/xdks/python/overview">
     Async support, type hints, and automatic token refresh. Perfect for data analysis and automation.
@@ -24,57 +22,36 @@ X provides official SDKs for TypeScript and Python with full X API v2 support.
   </Card>
 </CardGroup>
 
-### Why use the official SDKs?
-
-| Benefit | Description |
-|:--------|:------------|
-| **Always up-to-date** | Maintained by X, updated with new endpoints |
-| **Type safety** | Full type definitions for all objects and methods |
-| **Built-in auth** | OAuth 2.0 and OAuth 1.0a support |
-| **Automatic pagination** | Iterate through results without manual token handling |
-
 ### Quick start
 
 <Tabs>
   <Tab title="Python">
-#### Installation
-
 ```bash
 pip install xdk
 ```
 
-#### Basic usage
-
 ```python
 from xdk import Client
 
 client = Client(bearer_token="YOUR_BEARER_TOKEN")
 
-# Search for posts (returns an iterator)
 for page in client.posts.search_recent(query="api", max_results=10):
     if page.data and len(page.data) > 0:
-        first_post = page.data[0]
-        print(first_post.text)
+        print(page.data[0].text)
         break
 ```
 
 <Button href="/xdks/python/overview">Full Python guide</Button>
   </Tab>
   <Tab title="TypeScript">
-#### Installation
-
 ```bash
 npm install @xdevplatform/xdk
 ```
 
-#### Basic usage
-
 ```typescript
 import { Client } from '@xdevplatform/xdk';
 
 const client = new Client({ bearerToken: 'YOUR_BEARER_TOKEN' });
-
-// Look up a user
 const userResponse = await client.users.getByUsername('XDevelopers');
 console.log(userResponse.data?.username);
 ```
@@ -83,140 +60,29 @@ console.log(userResponse.data?.username);
   </Tab>
 </Tabs>
 
-### Authentication
-
-Both SDKs support multiple authentication methods:
-
-<Tabs>
-  <Tab title="Bearer Token (App-only)">
-Simplest option for reading public data.
-
-**Python:**
-```python
-from xdk import Client
-
-client = Client(bearer_token="YOUR_BEARER_TOKEN")
-```
-
-**TypeScript:**
-```typescript
-import { Client } from '@xdevplatform/xdk';
-
-const client = new Client({ bearerToken: 'YOUR_BEARER_TOKEN' });
-```
-  </Tab>
-  <Tab title="OAuth 2.0 (User Context)">
-For actions on behalf of users (posting, following, etc.).
-
-**Python:**
-```python
-from xdk import Client
-from xdk.oauth2_auth import OAuth2PKCEAuth
-
-auth = OAuth2PKCEAuth(
-    client_id="YOUR_CLIENT_ID",
-    redirect_uri="YOUR_CALLBACK_URL",
-    scope="tweet.read users.read offline.access"
-)
-
-# Get authorization URL
-auth_url = auth.get_authorization_url()
-
-# After user authorizes, exchange code for tokens
-tokens = auth.fetch_token(authorization_response=callback_url)
-client = Client(bearer_token=tokens["access_token"])
-```
-
-**TypeScript:**
-```typescript
-import { Client, OAuth2, generateCodeVerifier, generateCodeChallenge } from '@xdevplatform/xdk';
-
-const oauth2 = new OAuth2({
-  clientId: 'YOUR_CLIENT_ID',
-  clientSecret: 'YOUR_CLIENT_SECRET',
-  redirectUri: 'https://your-app.com/callback',
-  scope: ['tweet.read', 'users.read', 'offline.access'],
-});
-
-const codeVerifier = generateCodeVerifier();
-const codeChallenge = await generateCodeChallenge(codeVerifier);
-oauth2.setPkceParameters(codeVerifier, codeChallenge);
-const authUrl = await oauth2.getAuthorizationUrl('state');
-
-// After authorization, exchange code
-const tokens = await oauth2.exchangeCode(authCode, codeVerifier);
-const client = new Client({ accessToken: tokens.access_token });
-```
-  </Tab>
-  <Tab title="OAuth 1.0a (User Context)">
-For legacy applications or specific use cases.
-
-**Python:**
-```python
-from xdk import Client
-from xdk.oauth1_auth import OAuth1
-
-oauth1 = OAuth1(
-    api_key="YOUR_API_KEY",
-    api_secret="YOUR_API_SECRET",
-    access_token="YOUR_ACCESS_TOKEN",
-    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
-)
-
-client = Client(auth=oauth1)
-```
-
-**TypeScript:**
-```typescript
-import { Client, OAuth1 } from '@xdevplatform/xdk';
-
-const oauth1 = new OAuth1({
-  apiKey: 'YOUR_API_KEY',
-  apiSecret: 'YOUR_API_SECRET',
-  accessToken: 'YOUR_ACCESS_TOKEN',
-  accessTokenSecret: 'YOUR_ACCESS_TOKEN_SECRET'
-});
-
-const client = new Client({ oauth1: oauth1 });
-```
-  </Tab>
-</Tabs>
-
-### Available methods
-
-The SDKs provide methods for all X API v2 endpoints:
+---
 
-| Category | Python | TypeScript |
-|:---------|:-------|:-----------|
-| **Posts** | `client.posts.search_recent()` | `client.posts.search()` |
-| **Users** | `client.users.get_me()` | `client.users.getMe()` |
-| **Spaces** | `client.spaces.get()` | `client.spaces.findSpaceById()` |
-| **Lists** | `client.lists.get()` | `client.lists.getList()` |
-| **DMs** | `client.direct_messages.get()` | `client.directMessages.lookup()` |
+## Developer tools
 
 <CardGroup cols={2}>
-  <Card title="Python SDK Docs" icon="book" href="/xdks/python/overview">
-    Complete Python documentation.
+  <Card title="Postman Collection" icon="server" href="https://www.postman.com/xapidevelopers/x-api-public-workspace/collection/34902927-2efc5689-99c6-4ab6-8091-996f35c2fd80">
+    Interactive API testing for all v2 endpoints.
   </Card>
-  <Card title="TypeScript SDK Docs" icon="book" href="/xdks/typescript/overview">
-    Complete TypeScript documentation.
+  <Card title="xurl" icon="terminal" href="/tools/xurl">
+    curl-like CLI for the X API with built-in OAuth authentication. No manual token management.
   </Card>
-  <Card title="Python GitHub" icon="github" href="https://github.com/xdevplatform/xdk-py">
-    Source code and issues.
+  <Card title="API Playground" icon="flask" href="https://github.com/xdevplatform/playground">
+    Local mock server for testing X API v2 endpoints without using real credits.
   </Card>
-  <Card title="TypeScript GitHub" icon="github" href="https://github.com/xdevplatform/twitter-api-typescript-sdk">
-    Source code and issues.
+  <Card title="AI & LLM Resources" icon="sparkles" href="/tools/ai-docs">
+    XMCP, llms.txt, skill.md, docs MCP server, and resources for AI-powered development.
   </Card>
 </CardGroup>
 
----
-
-## Official tools
+### Other tools
 
 | Tool | Description |
 |:-----|:------------|
-| [Postman Collection](https://www.postman.com/xapidevelopers/x-api-public-workspace/collection/34902927-2efc5689-99c6-4ab6-8091-996f35c2fd80) | Interactive API testing for all v2 endpoints |
-| [xurl](https://github.com/xdevplatform/xurl) | Command line tool for the X APIs that handles authentication for you |
 | [OpenAPI Spec](https://api.x.com/2/openapi.json) | Machine-readable API specification |
 | [twitter-text](https://github.com/twitter/twitter-text) | Parse and validate post text, count characters |
 | [Embed Generator](https://publish.x.com/#) | Build embeddable posts, timelines, or buttons for your site |
@@ -225,7 +91,7 @@ The SDKs provide methods for all X API v2 endpoints:
 
 ## Community libraries
 
-These community-maintained libraries support X API v2. Check each library's documentation for current API coverage.
+Community-maintained libraries with X API v2 support. Check each library's documentation for current coverage.
 
 <Tabs>
   <Tab title="Python">
@@ -289,35 +155,14 @@ Community libraries are not maintained by X. Check their repositories for suppor
 
 ---
 
-## X Ads API libraries
-
-For tools and libraries specific to the X Ads API, see the [Ads API tools and libraries](/x-ads-api/tools-and-libraries) page.
-
----
-
 ## Code samples
 
-Find examples on GitHub:
-
-- [X API v2 Sample Code](https://github.com/xdevplatform/Twitter-API-v2-sample-code) - Examples in Python, JavaScript, Ruby, and more
-- [X Developer GitHub](https://github.com/xdevplatform) - Official repos and tools
-- [Code Samples Repo](https://github.com/xdevplatform/samples) - Examples using the official XDKs
-- [Glitch Examples](https://glitch.com/@twitter) - Interactive, remixable apps
-- [Replit Examples](https://replit.com/@twitter) - Browser-based coding
-
----
-
-## Building a library?
-
-If you have built an X API library, share it with the community:
-
-1. Post in the [Libraries and SDKs forum](https://devcommunity.x.com/c/libraries-and-sdks/63)
-2. We may add it to this page!
+- [X API v2 Sample Code](https://github.com/xdevplatform/Twitter-API-v2-sample-code) — Examples in Python, JavaScript, Ruby, and more
+- [Code Samples Repo](https://github.com/xdevplatform/samples) — Examples using the official XDKs
+- [X Developer GitHub](https://github.com/xdevplatform) — Official repos and tools
 
 ---
 
-## Getting help
+## X Ads API libraries
 
-<Card title="Developer Forum" icon="comments" href="https://devcommunity.x.com">
-  Get help from the community.
-</Card>
+For tools and libraries specific to the X Ads API, see the [Ads API tools and libraries](/x-ads-api/tools-and-libraries) page.