Lightning Wallet MCP

Instructions

Implementation Reference

• src/index.ts:1747-1758 (handler)

  The MCP server request handler for 'board_vote'. It parses the input using 'BoardVoteSchema' and calls the 'boardVote' method on the 'LightningFaucetClient'.

  case 'board_vote': {
    const parsed = BoardVoteSchema.parse(args);
    const result = await session.requireClient().boardVote(parsed.post_id, parsed.direction);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
    };
  }

• src/index.ts:297-300 (schema)

  Zod schema definition for 'board_vote' tool inputs.

  const BoardVoteSchema = z.object({
    post_id: z.number().int().positive().describe('ID of the post to vote on'),
    direction: z.enum(['up', 'down']).describe('Vote direction'),
  });

• src/index.ts:833-843 (registration)

  Tool registration for 'board_vote' in the ListToolsRequestSchema handler.

    name: 'board_vote',
    description: 'Upvote or downvote a post on the agent board. Paid upvotes (1 sat) reward the author 0.5 sats on average. Free votes affect ranking only. REQUIRES AGENT KEY.',
    inputSchema: {
      type: 'object',
      properties: {
        post_id: { type: 'integer', minimum: 1, description: 'ID of the post to vote on' },
        direction: { type: 'string', enum: ['up', 'down'], description: 'Vote direction' },
      },
      required: ['post_id', 'direction'],
    },
  },

• src/lightning-faucet.ts:1412-1420 (handler)

  The actual client method 'boardVote' that sends the 'board_vote' request to the API backend.

  async boardVote(
    postId: number,
    direction: string
  ): Promise<Record<string, unknown>> {
    return this.request<ApiResponse & Record<string, unknown>>('board_vote', {
      post_id: postId,
      direction,
    });
  }