MCP-researcher Server

Instructions

Implementation Reference

• src/index.ts:362-375 (handler)

  Handler logic for the 'reason' tool: sets the Perplexity model to 'sonar-reasoning-pro' and constructs a detailed multi-step reasoning prompt based on the input query.

            case "reason": {
              model = "sonar-reasoning-pro";
              prompt = `You are answering a query that contains specific details like error messages, logs, code snippets, exact terminology, version numbers, and context. Carefully analyze all provided details to give the most accurate and helpful answer.
  
  Query: ${query}
  
  Provide a detailed explanation and analysis that:
  1. Addresses the specific details provided (errors, logs, code, versions, etc.)
  2. Includes step-by-step reasoning based on the actual context
  3. Identifies key considerations relevant to the specific situation
  4. Provides relevant examples matching the described scenario
  5. Offers practical implications based on the exact details provided
  6. Suggests potential alternatives or solutions tailored to the specific context`;
              break;

• src/index.ts:285-299 (schema)

  Input schema for the 'reason' tool, defining the 'query' parameter as required string and optional 'force_model' boolean.

  inputSchema: {
    type: "object",
    properties: {
      query: {
        type: "string",
        description: "The complex query or task to reason about. IMPORTANT: Be extremely specific and include all relevant details:\n- Include exact error messages, logs, and stack traces if applicable\n- Provide exact terminology, function names, API names, version numbers\n- Include relevant code snippets showing the problem or context\n- Specify platform, OS, framework versions, and environment details\n- Mention any attempted solutions or workarounds\n- Provide context about what you're trying to achieve\n- Include relevant data structures, configurations, or inputs\n\nThe more specific details you include, the more accurate and helpful the answer will be.\nIf you don't have enough specific information, prompt the user to provide it before using this tool."
      },
      force_model: {
        type: "boolean",
        description: "Optional: Force using this model even if query seems simple/research-oriented",
        default: false
      }
    },
    required: ["query"]
  }

• src/index.ts:282-300 (registration)

  Registration of the 'reason' tool in the MCP server's listTools response, including name, description, and input schema.

  {
    name: "reason",
    description: "Handles complex, multi-step tasks using Perplexity's Sonar Reasoning Pro model. Best for explanations, comparisons, and problem-solving.",
    inputSchema: {
      type: "object",
      properties: {
        query: {
          type: "string",
          description: "The complex query or task to reason about. IMPORTANT: Be extremely specific and include all relevant details:\n- Include exact error messages, logs, and stack traces if applicable\n- Provide exact terminology, function names, API names, version numbers\n- Include relevant code snippets showing the problem or context\n- Specify platform, OS, framework versions, and environment details\n- Mention any attempted solutions or workarounds\n- Provide context about what you're trying to achieve\n- Include relevant data structures, configurations, or inputs\n\nThe more specific details you include, the more accurate and helpful the answer will be.\nIf you don't have enough specific information, prompt the user to provide it before using this tool."
        },
        force_model: {
          type: "boolean",
          description: "Optional: Force using this model even if query seems simple/research-oriented",
          default: false
        }
      },
      required: ["query"]
    }
  },