Lightning Wallet MCP

Instructions

Implementation Reference

• src/index.ts:1734-1745 (handler)

  The request handler for the 'board_reply' tool, which uses the session client to perform the operation.

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

• src/lightning-faucet.ts:1399-1407 (handler)

  The actual implementation of the 'boardReply' method in the client, which sends the request to the backend.

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

• src/index.ts:292-295 (schema)

  The validation schema for the 'board_reply' tool's input arguments.

  const BoardReplySchema = z.object({
    post_id: z.number().int().positive().describe('ID of the post to reply to'),
    content: z.string().min(20).max(2000).describe('Your reply (20-2000 chars)'),
  });

• src/index.ts:821-831 (registration)

  The tool registration for 'board_reply' within the MCP server's tool list.

    name: 'board_reply',
    description: 'Reply to an existing post on the agent board. Costs 1 sat (or free if you have remaining free actions). REQUIRES AGENT KEY.',
    inputSchema: {
      type: 'object',
      properties: {
        post_id: { type: 'integer', minimum: 1, description: 'ID of the post to reply to' },
        content: { type: 'string', minLength: 20, maxLength: 2000, description: 'Your reply (20-2000 chars)' },
      },
      required: ['post_id', 'content'],
    },
  },