get_related_keywords

Find related keywords for a search query to expand research or content creation. Input a query to receive a list of associated terms.

Instructions

Get keywords related to a search query

Input Schema

TableJSON Schema

Name	Required	Description	Default
`query`	Yes	Search query
`limit`	No	Number of keywords to return (default: 10)

Implementation Reference

server.js:918-931 (handler)

MCP tool handler for 'get_related_keywords'. Parses arguments, invokes the API client method, and formats the response as MCP content.

handler: async (args) => {
  const { query, limit = 10 } = args;
  const result = await apiClient.getRelatedKeywords(query, limit);
  return {
    content: [{
      type: "text",
      text: JSON.stringify({
        success: true,
        data: result,
        message: `Found ${result.items?.length || 0} related keywords for "${query}"`
      }, null, 2)
    }]
  };
}

server.js:903-917 (schema)

Input schema defining the parameters for the get_related_keywords tool: required 'query' string and optional 'limit' number.

inputSchema: {
  type: "object",
  properties: {
    query: {
      type: "string",
      description: "Search query"
    },
    limit: {
      type: "number",
      description: "Number of keywords to return (default: 10)",
      default: 10
    }
  },
  required: ["query"]
},

server.js:900-932 (registration)

Full tool registration object in the tools array for 'get_related_keywords', including name, description, schema, and handler.

{
  name: "get_related_keywords",
  description: "Get keywords related to a search query",
  inputSchema: {
    type: "object",
    properties: {
      query: {
        type: "string",
        description: "Search query"
      },
      limit: {
        type: "number",
        description: "Number of keywords to return (default: 10)",
        default: 10
      }
    },
    required: ["query"]
  },
  handler: async (args) => {
    const { query, limit = 10 } = args;
    const result = await apiClient.getRelatedKeywords(query, limit);
    return {
      content: [{
        type: "text",
        text: JSON.stringify({
          success: true,
          data: result,
          message: `Found ${result.items?.length || 0} related keywords for "${query}"`
        }, null, 2)
      }]
    };
  }
},

server.js:207-210 (helper)

Supporting method in WebSimAPIClient that performs the actual HTTP request to retrieve related keywords from the WebSim API endpoint `/api/v1/search/related`.

async getRelatedKeywords(query, limit = 10) {
  const params = new URLSearchParams({ q: query, limit: limit.toString() });
  return this.makeRequest(`/api/v1/search/related?${params}`);
}

WebSim MCP Server