Large scale changes to fix some broken urls, improve structure of pages, and improve pages overall

Author: bsyedumar

docs/account-management/subscription-management.mdx

@@ -89,7 +89,7 @@ When your account switches to the Free tier:
 
 - You’ll receive an automatic downgrade email  
 - The email includes new plan limits  
-- Review feature access on the [Plans and Pricing](https://smythos.com/pricing) page
+- Review feature access on the [Plans and Pricing](https://smythos.com/pricing/) page
 
 ### Billing Period Notes
 
@@ -114,7 +114,7 @@ Roles are managed via [Organization Management](/docs/account-management/organiz
 ## Need Help?
 
 <TipCallout title="Have a billing or subscription question?">
-Contact [Support](https://smythos.com/talk-to-us), or post in the [Discord server](https://discord.gg/smythos) for help from the community or team.
+Contact [Support](https://smythos.com/talk-to-us/), or post in the [Discord server](https://discord.gg/smythos) for help from the community or team.
 </TipCallout>
 
 <Spacer size="md" />

docs/agent-collaboration/data-pool/custom-storage.mdx

@@ -50,7 +50,7 @@ Advanced users can use the `API Call` component to communicate directly with Pin
 To configure:
 
 - Add your Pinecone API key from the **Vault**  
-- Use endpoint URLs from [Pinecone's API reference](https:/docs.pinecone.io/reference)  
+- Use endpoint URLs from [Pinecone's API reference](https://docs.pinecone.io/reference)  
 - Pass headers, payloads, and parameters manually  
 
 <WarningCallout title="Vector dimension must be 1536">

docs/agent-deployments/deployments/_category_.json

@@ -1,4 +1,5 @@
 {
 	"label": "Deploy Your Agent As...",
-	"collapsed": true
+	"collapsed": true,
+	"position": 4
 }

docs/agent-deployments/deployments/deploy-as-alexa-skill.mdx

@@ -8,8 +8,8 @@ description: How to deploy your SmythOS agent as an Alexa Skill using Amazon Dev
 
 > **Your agent, now voice-enabled.** Connect it to Alexa and let users talk to it like a human.
 
-<InfoCallout> **TL;DR:** Copy your SmythOS Alexa endpoint → set up a Custom Alexa Skill → wire the endpoint as your handler. Alexa now speaks for your agent. </InfoCallout>
-<Divider />
+<InfoCallout title="TL;DR">  Copy your SmythOS Alexa endpoint → set up a Custom Alexa Skill → wire the endpoint as your handler. Alexa now speaks for your agent. </InfoCallout>
+<Spacer size="md" /> 
 ## Why Deploy Your Agent to Alexa?
 
 Voice extends your agent’s reach. Alexa integration lets users interact naturally with no screens or keyboards required. It’s ideal for:
@@ -20,7 +20,7 @@ Voice extends your agent’s reach. Alexa integration lets users interact natura
 - Productivity helpers
 
 All it takes is one endpoint and a little setup.
-<Divider />
+<Spacer size="md" /> 
 ## Prerequisites
 
 Make sure you have the following ready:
@@ -29,7 +29,7 @@ Make sure you have the following ready:
 - An Amazon Developer account ([sign up here](https://developer.amazon.com/alexa))
 - Basic agent behavior already configured
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Step 1: Get Your SmythOS Alexa Endpoint URL
 
@@ -43,7 +43,7 @@ https://<your-agent>.agent.stage.smyth.ai/alexa
 ```
 
 <InfoCallout> For production, swap `stage` with `pstage`. </InfoCallout>
-<Divider />
+<Spacer size="md" /> 
 
 ## Step 2: Create a New Alexa Skill in the Developer Console
 
@@ -54,7 +54,7 @@ https://<your-agent>.agent.stage.smyth.ai/alexa
 5. Select **Start from scratch**
 6. Click **Create Skill**
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Step 3: Add Your SmythOS Endpoint as the Skill Handler
 
@@ -65,15 +65,15 @@ https://<your-agent>.agent.stage.smyth.ai/alexa
    - `My development endpoint is a sub-domain...`
 5. Save changes
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Step 4: Choose an Invocation Name for Your Skill
 
 1. In the sidebar, go to **Invocation**
 2. Enter how users will launch your agent (e.g., "my agent")
 3. Save the model
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Step 5: Add a Custom Intent for User Queries
 
@@ -93,7 +93,7 @@ search for {searchQuery}
 5. When prompted, create the `searchQuery` slot
 6. Set its type to `AMAZON.SearchQuery`
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Step 6: Build and Test Your Alexa Skill
 
@@ -107,7 +107,7 @@ Alexa, open my agent
 Alexa, ask what’s the weather in New York
 ```
 
-<Divider />
+<Spacer size="md" /> 
 
 ## How Your Alexa-Connected Agent Works Behind the Scenes
 
@@ -116,7 +116,7 @@ Alexa, ask what’s the weather in New York
 - SmythOS handles it and returns a response
 - Alexa reads the agent’s reply aloud
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Known Limitations and Constraints
 
@@ -125,7 +125,7 @@ Alexa, ask what’s the weather in New York
 - Visuals and complex UI are not supported
 - Users must re-invoke your skill after each interaction
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Optional: Publish Your Alexa Skill to the Public
 
@@ -141,7 +141,7 @@ Want to go public?
 
 <PromptCard prompt="Connect your public SmythOS agent to Alexa by using the HTTPS endpoint and defining a searchQuery intent." />
 
-<Divider />
+<Spacer size="md" /> 
 
 ## What’s Next?
 

docs/agent-deployments/deployments/deploy-as-api.mdx

@@ -12,7 +12,7 @@ description: How to use your SmythOS agent via direct API calls using Swagger UI
 **TL;DR:** Open your agent’s API embodiment, grab the OpenAPI URL, and use the Swagger interface to test, verify, and integrate.
 </InfoCallout>
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Why Access Your Agent via API?
 
@@ -23,7 +23,7 @@ This method is ideal if you want to:
 - Integrate with other tools, backends, or systems without using UI elements
 - Reuse agent logic across internal apps, CRMs, dashboards, or mobile apps
 
-<Divider />
+<Spacer size="md" /> 
 
 ## What You Need Before You Start
 
@@ -33,7 +33,7 @@ Before interacting with the API embodiment, make sure:
 - You have a Vault API key with the correct scopes
 - You know your environment’s [subdomain](/docs/agent-deployments/subdomains) URL (`stage` or `pstage`)
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Step-by-Step: Use the SmythOS Agent API
 
@@ -47,7 +47,7 @@ Before interacting with the API embodiment, make sure:
 Each endpoint maps to a callable block or function in your agent logic.
 </InfoCallout>
 
-<Divider />
+<Spacer size="md" /> 
 
 ### Step 2: Get the OpenAPI URL for Your Agent
 
@@ -68,7 +68,7 @@ You can import this URL into third-party tools like Postman or [GPT Builder](/do
 
 <PromptCard prompt="Paste your OpenAPI URL into tools like Swagger, Postman, or GPT Builder to explore endpoints." />
 
-<Divider />
+<Spacer size="md" /> 
 
 ### Step 3: Test and Explore Endpoints with Swagger
 
@@ -82,7 +82,7 @@ You can import this URL into third-party tools like Postman or [GPT Builder](/do
 Swagger does not support multi-line JSON by default. Keep payloads single-line or escape newline characters.
 </WarningCallout>
 
-<Divider />
+<Spacer size="md" /> 
 
 ## What Comes After API Integration?
 
@@ -94,4 +94,4 @@ Now that your API is live:
 
 Want to make it conversational? Learn how to [Deploy as ChatBot](/docs/agent-deployments/deployments/deploy-as-chatbot) and embed the same logic into your site’s UI.
 
-<Divider />
+<Spacer size="md" /> 

docs/agent-deployments/deployments/deploy-as-mcp-server.mdx

@@ -12,7 +12,7 @@ description: How to deploy your SmythOS agent using the Model Context Protocol (
 **TL;DR:** Enable MCP in your agent settings, copy the development or production MCP URL, and plug it into your MCP-compatible platform.
 </InfoCallout>
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Why Enable MCP Support for Your Agent?
 
@@ -28,7 +28,7 @@ This is ideal for:
 - IDE or toolchain integrations
 - Enterprise systems requiring protocol-based interoperability
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Prerequisites
 
@@ -45,7 +45,7 @@ Production environments use:
 `https://<agent-id>.agent.psatge.smyth.ai`
 </InfoCallout>
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Step-by-Step: Enable and Integrate MCP
 
@@ -58,7 +58,7 @@ Production environments use:
 
 This will generate unique MCP URLs for test and production.
 
-<Divider />
+<Spacer size="md" /> 
 
 ### Step 2: Copy Your MCP Endpoint URL
 
@@ -76,7 +76,7 @@ Choose based on your integration stage:
 
 <PromptCard prompt="Use the test MCP URL during development, and switch to production (psatge) for stable launches." />
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Security Considerations for MCP Endpoints
 
@@ -92,7 +92,7 @@ To add auth protection, use:
 
 Always secure your production MCP endpoints appropriately.
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Common Use Cases for MCP Integration
 
@@ -102,7 +102,7 @@ Always secure your production MCP endpoints appropriately.
 
 <PromptCard prompt="Paste your MCP URL into any compatible platform. Your agent will begin responding contextually." />
 
-<Divider />
+<Spacer size="md" /> 
 
 ## What’s Next?
 
@@ -116,4 +116,4 @@ Same agent, multiple endpoints. Maximum reusability.
 
 <PromptCard prompt="Enable MCP on your SmythOS agent, grab the appropriate URL, and integrate with your preferred MCP-ready platform." />
 
-<Divider />
+<Spacer size="md" /> 

docs/agent-deployments/deployments/deploy-as-siri-webhook.mdx

@@ -8,9 +8,9 @@ keywords: [Siri, SmythOS, Webhook, Shortcuts, voice automation, iOS automation,
 
 > Trigger agents with your voice. Connect Apple’s Siri Shortcuts to SmythOS using secure webhook URLs and unlock hands-free workflows on iOS.
 
-<InfoCallout> **TL;DR:** Set up a Siri Shortcut that sends an HTTP request to your SmythOS agent's webhook endpoint, and your voice becomes your interface. </InfoCallout>
+<InfoCallout title="TL;DR">  Set up a Siri Shortcut that sends an HTTP request to your SmythOS agent's webhook endpoint, and your voice becomes your interface. </InfoCallout>
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Why Use Siri to Activate Your SmythOS Agent?
 
@@ -23,7 +23,7 @@ With this integration, you can:
 - Build accessibility-friendly AI assistants
 - Combine native iOS automations with your SmythOS agents
 
-<Divider />
+<Spacer size="md" /> 
 
 ## What You Need to Get Started
 
@@ -32,7 +32,7 @@ With this integration, you can:
 - iPhone or iPad with iOS 14+
 - The **Shortcuts** app installed (usually default on iOS)
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Step 1: Get Your SmythOS Webhook URL
 
@@ -43,7 +43,7 @@ With this integration, you can:
 
 <InfoCallout> You can test this webhook first using [Postman](https://www.postman.com/) - [we also have a guide on how](/docs/agent-deployments/deployments/use-postman) - or `curl` to ensure it responds correctly before adding it to Siri. </InfoCallout>
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Step 2: Set Up Your Siri Shortcut
 
@@ -65,7 +65,7 @@ With this integration, you can:
 5. (Optional) Add a **Text** action or `Show Result` to display the response  
 6. Name your Shortcut (e.g., "Run SmythOS Agent") and enable Siri by tapping **Add to Siri**
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Step 3: Trigger the Agent with Your Voice
 
@@ -75,7 +75,7 @@ Once added, just say:
 
 …and the webhook will be triggered, sending data to your agent and receiving the response in your shortcut flow.
 
-<Divider />
+<Spacer size="md" /> 
 
 ## Handle and Display the Agent Response
 
@@ -87,7 +87,7 @@ You can enhance the Shortcut by:
 
 <InfoCallout> Pro tip: Use the response JSON fields to power conditional logic or route data to other iOS apps. </InfoCallout>
 
-<Divider />
+<Spacer size="md" /> 
 
 ## What’s Next?
 
@@ -97,4 +97,4 @@ You can enhance the Shortcut by:
 
 <PromptCard prompt="Use Siri to trigger your SmythOS agent via webhook and complete tasks using just your voice." />
 
-<Divider />
+<Spacer size="md" />