AWS Knowledge MCP Server endpoint returning 404 error

[ajitnk-lab]

Issue Description

The aws-knowledge-mcp-server configured in Amazon Q CLI is failing to load with a connection closed error during initialization. The remote endpoint https://knowledge-mcp.global.api.aws is returning a 404 error.

Configuration

The server is configured in ~/.aws/amazonq/mcp.json as:

"aws-knowledge-mcp-server": {
  "type": "stdio",
  "command": "npx",
  "args": [
    "mcp-remote",
    "https://knowledge-mcp.global.api.aws"
  ],
  "env": {
    "NODE_OPTIONS": "--max-old-space-size=1024",
    "FASTMCP_LOG_LEVEL": "ERROR"
  },
  "timeout": 120000,
  "disabled": false
}

Error Details

Q CLI Log Error:

Error loading server aws-knowledge-mcp-server: McpError(ErrorData { code: ErrorCode(-32002), message: "connection closed: initialize response", data: None })

HTTP Response:

$ curl -I https://knowledge-mcp.global.api.aws
HTTP/2 404 
date: Wed, 29 Oct 2025 07:20:59 GMT
x-amzn-requestid: 76cbdafc-26d3-4c7c-8ada-be07d3730b50
x-cache: Error from cloudfront
via: 1.1 3caf9df4ca497afd40efb87f8957a7fa.cloudfront.net (CloudFront)
x-amz-cf-pop: HIO52-P4
x-amz-cf-id: eiMTzNZCUaKEuPIKjQ2wq_eL8QrxAN4hhS6bTyiD4ru_e7GGyEsLXQ==

Environment

• mcp-remote version: 0.1.29 (latest)
• Node.js version: v20.19.5
• OS: Linux (Ubuntu)
• AWS CLI: Configured and working (credentials verified)

Expected Behavior

The AWS Knowledge MCP server should successfully initialize and provide knowledge base functionality.

Actual Behavior

The server fails to initialize due to the remote endpoint returning a 404 error, causing the MCP server to fail loading in Q CLI.

Questions

1. Is https://knowledge-mcp.global.api.aws the correct endpoint for the AWS Knowledge MCP server?
2. Is this service currently available or has it been deprecated?
3. Are there alternative endpoints or authentication requirements?
4. Should this be reported to AWS instead of the mcp-remote project?

Workaround

Currently disabling the server in the configuration to avoid initialization errors:

"disabled": true

[clouatre]

Cannot Reproduce

Tested on November 9, 2025 with the configuration from your issue:

{
  "aws-knowledge-mcp-server": {
    "type": "stdio",
    "command": "npx",
    "args": ["mcp-remote", "https://knowledge-mcp.global.api.aws"],
    "env": {
      "NODE_OPTIONS": "--max-old-space-size=1024",
      "FASTMCP_LOG_LEVEL": "ERROR"
    },
    "timeout": 120000,
    "disabled": false
  }
}

Test environment:

• Amazon Q CLI: 1.19.3
• Node.js: v25.1.0
• mcp-remote: 0.1.29 and 0.1.30 (both tested and working)

Results:

• Server loads successfully
• All 5 AWS tools functional
• Multiple requests completed without errors

Alternative Q configurations (legacy mcp.json or cli-agents):

Simplified (without env vars):

{
  "aws-knowledge-mcp-server": {
    "type": "stdio",
    "command": "mcp-remote",
    "args": ["https://knowledge-mcp.global.api.aws"]
  }
}

Native HTTP transport (mcp-remote not required):

{
  "aws-knowledge-mcp-server": {
    "type": "http",
    "url": "https://knowledge-mcp.global.api.aws"
  }
}

Compare your environment (Q CLI version, Node.js version, network) to identify differences.