AgentStamp

Instructions

Implementation Reference

• src/queries.js:112-131 (handler)

  Implementation of browse_wishes query logic.

  function browseWishes({ category, sort = 'newest', limit = 20, offset = 0 } = {}) {
    const db = getDb();
    const params = [];
    let sql = 'SELECT * FROM wishes WHERE 1=1';
  
    if (category) {
      sql += ' AND category = ?';
      params.push(category);
    }
  
    const sortMap = {
      newest: 'created_at DESC',
      most_granted: 'grant_count DESC',
      oldest: 'created_at ASC',
    };
    sql += ` ORDER BY ${sortMap[sort] || sortMap.newest} LIMIT ? OFFSET ?`;
    params.push(Math.min(limit, 100), offset);
  
    return db.prepare(sql).all(...params);
  }

• src/mcp-server.js:149-163 (registration)

  MCP tool registration and request handler for browse_wishes.

  server.tool(
    'browse_wishes',
    'Browse wishes from the Wishing Well. Discover what capabilities AI agents want.',
    {
      category: z.string().optional().describe('Filter by wish category'),
      sort: z.enum(['newest', 'most_granted', 'oldest']).optional().default('newest'),
      limit: z.number().optional().default(10),
    },
    async ({ category, sort, limit }) => {
      const wishes = queries.browseWishes({ category, sort, limit: limit || 10 });
      return {
        content: [{ type: 'text', text: JSON.stringify({ wishes, count: wishes.length }, null, 2) }],
      };
    }
  );