Nostr Tools for AI Agents

Instructions

Implementation Reference

• src/tools/social-tools.ts:113-127 (handler)

  The implementation of the reactToEvent handler which constructs a NIP-25 reaction event template and publishes it.

  export async function reactToEvent({ eventId, eventPubkey, reaction, privateKey, relays }: z.infer<typeof reactToEventSchema>) {
    const template: EventTemplate = {
      kind: KINDS.REACTION,
      content: reaction ?? '+',
      tags: [
        ['e', eventId],
        ['p', normalizePubkey(eventPubkey)],
      ],
      created_at: Math.floor(Date.now() / 1000),
    };
  
    const signed = await signTemplate(template, privateKey);
    const result = await publishEvent(signed, relays ?? DEFAULT_RELAYS);
    return { event: signed, published: result };
  }

• src/tools/social-tools.ts:21-27 (schema)

  The Zod schema defining inputs for reactToEvent.

  export const reactToEventSchema = z.object({
    eventId: z.string().describe('ID of the event to react to'),
    eventPubkey: z.string().describe('Pubkey of the event author'),
    reaction: z.string().optional().default('+').describe('Reaction content (default: "+")'),
    privateKey: z.string().optional().describe(privateKeyDesc),
    relays: z.array(z.string()).optional().describe('Relays to publish to'),
  });

• src/index.ts:107-108 (registration)

  Registration of the reactToEvent tool in the MCP server.

  server.tool('reactToEvent', 'React to an event (kind 7)', reactToEventSchema.shape, async (params) => {
    return textResult(await reactToEvent(params));