Saros MCP Server

Instructions

Implementation Reference

• src/tools/get-farm-positions.js:5-59 (handler)

  Primary handler function that executes the get_farm_positions tool logic: validates wallet input, fetches positions from farmService, formats output as formatted text response, handles empty results and errors.

  async function getFarmPositionsTool(args, farmService) {
    const { wallet } = args;
  
    if (!wallet) {
      throw new Error("Wallet address is required");
    }
  
    try {
      const positions = await farmService.getFarmPositions(wallet);
  
      if (positions.length === 0) {
        return {
          content: [
            {
              type: "text",
              text: `No farm positions found for wallet: ${wallet}`,
            },
          ],
        };
      }
  
      // Format positions
      let positionsText = `**Farm Positions for ${wallet}**\n\n`;
      positionsText += `Total Farms: ${positions.length}\n\n`;
  
      positions.forEach((pos, idx) => {
        positionsText +=
          `**Position ${idx + 1}:**\n` +
          `- Farm: ${pos.farmAddress}\n` +
          `- LP Token: ${pos.lpAddress}\n` +
          `- Staked Amount: ${pos.stakedAmount}\n` +
          `- Pool: ${pos.token0} / ${pos.token1}\n`;
  
        if (pos.pendingRewards && pos.pendingRewards.length > 0) {
          positionsText += `- Pending Rewards:\n`;
          pos.pendingRewards.forEach((reward) => {
            positionsText += `  • ${reward.amount} ${reward.symbol}\n`;
          });
        }
  
        positionsText += `\n`;
      });
  
      return {
        content: [
          {
            type: "text",
            text: positionsText,
          },
        ],
      };
    } catch (error) {
      throw new Error(`Failed to get farm positions: ${error.message}`);
    }
  }

• src/index.js:101-114 (schema)

  Schema definition for the get_farm_positions tool, including input schema (wallet address required), provided in the ListTools response for tool discovery.

    name: "get_farm_positions",
    description:
      "Get all farming positions and staking rewards for a wallet. Shows staked LP tokens and claimable rewards.",
    inputSchema: {
      type: "object",
      properties: {
        wallet: {
          type: "string",
          description: "Solana wallet address",
        },
      },
      required: ["wallet"],
    },
  },

• src/index.js:165-166 (registration)

  Tool registration in the central CallToolRequestSchema handler: dispatches calls to get_farm_positions to the specific getFarmPositionsTool function with farmService.

  case "get_farm_positions":
    return await getFarmPositionsTool(args, this.farmService);

• src/index.js:19-19 (registration)

  Import of the getFarmPositionsTool handler from its dedicated tool module.

  const { getFarmPositionsTool } = require("./tools/get-farm-positions.js");

• src/services/farm-service.js:8-11 (helper)

  Supporting service method called by the tool handler to retrieve farm positions data (currently a stub implementation).

  async getFarmPositions(walletAddress) {
    // Return empty for demo
    return [];
  }