fix: resolve CI failures and Vale linting errors

- Remove empty fern/apis/fern-docs-mcp directory causing CI failure
- Change 'API reference' to 'API Reference' per FernStyles.Reject rule
- Use contractions (isn't, doesn't) per Microsoft.Contractions
- Define SSO (Single sign-on) on first use per FernStyles.Acronyms
- Fix broken link in api-get-started.mdx to use correct path
- Remove download link to openapi.yaml (file not hosted)

Co-Authored-By: [email protected] <[email protected]>

Author: devin-ai-integration[bot]

fern/apis/fern-docs-mcp/openapi.yaml

@@ -13,7 +13,7 @@ The Model Context Protocol (MCP) server endpoints allow AI agents and automated
 - **Automated testing**: Programmatically verify documentation content and search functionality
 - **Custom integrations**: Build tools that need to access protected documentation content
 
-## API reference
+## API Reference
 
 ### Exchange an API key for a JWT
 
@@ -51,12 +51,12 @@ GET /api/fern-docs/get-jwt
 
 | Status | Description |
 |--------|-------------|
-| 400 | JWT generation is not accessible in local preview mode |
-| 400 | JWT generation is not supported in self-hosted environments |
-| 400 | SSO/WorkOS authentication is not supported by this endpoint |
+| 400 | JWT generation isn't accessible in local preview mode |
+| 400 | JWT generation isn't supported in self-hosted environments |
+| 400 | Single sign-on (SSO)/WorkOS authentication isn't supported by this endpoint |
 | 401 | Missing `FERN_API_KEY` header |
 | 401 | Invalid API key |
-| 403 | API key does not belong to the organization that owns this domain |
+| 403 | API key doesn't belong to the organization that owns this domain |
 | 500 | Authentication configuration error or JWT generation failed |
 
 #### Example
@@ -134,10 +134,10 @@ Alternatively, the `FERN_TOKEN` can be provided as a cookie instead of a header.
 
 | Status | Description |
 |--------|-------------|
-| 400 | Search key is not accessible in local preview mode |
-| 400 | Search is not supported for preview URLs (unless explicitly enabled) |
+| 400 | Search key isn't accessible in local preview mode |
+| 400 | Search isn't supported for preview URLs (unless explicitly enabled) |
 | 401 | Invalid API key |
-| 403 | API key does not belong to the organization that owns this domain |
+| 403 | API key doesn't belong to the organization that owns this domain |
 
 #### Example with API key
 
@@ -170,7 +170,7 @@ curl -X GET https://docs.example.com/api/fern-docs/search/v2/key \
 
 ## OpenAPI specification
 
-Download the complete OpenAPI specification for these endpoints:
+The complete OpenAPI specification for these endpoints:
 
 ```yaml
 openapi: 3.1.0
@@ -323,5 +323,3 @@ paths:
         '403':
           description: Forbidden (API key does not belong to organization)
 ```
-
-You can also download this specification as a file: [openapi.yaml](/apis/fern-docs-mcp/openapi.yaml)

fern/products/ask-fern/pages/features/mcp-server.mdx

@@ -15,4 +15,4 @@ The Fern AI API allows you to manage your Ask Fern configuration using Fern's pu
 
 Fern API requests require a bearer token for authentication. Use the CLI command [`fern token`](/learn/cli-api/cli-reference/commands#fern-token) to generate a bearer token. Tokens do not expire.
 
-For MCP agents and automated tools that need to authenticate and search your documentation, see the [MCP server documentation](/learn/ask-fern/mcp-server).
+For MCP agents and automated tools that need to authenticate and search your documentation, see the [MCP server documentation](/learn/ask-fern/features/mcp-server).