Nostr Tools for AI Agents

Instructions

Implementation Reference

• src/tools/event-tools.ts:49-63 (handler)

  The signNostrEvent handler function which determines if it should use a NIP-46 bunker signer or a direct private key signer.

  export async function signNostrEvent({ unsignedEvent, privateKey }: z.infer<typeof signNostrEventSchema>): Promise<VerifiedEvent> {
    const template: EventTemplate = {
      kind: unsignedEvent.kind,
      content: unsignedEvent.content,
      tags: unsignedEvent.tags,
      created_at: unsignedEvent.created_at,
    };
  
    if (isBunkerMode()) {
      return signEventWithBunker(template);
    }
    if (!privateKey) throw new Error('privateKey is required when NOSTR_BUNKER_URI is not configured');
    const sk = normalizePrivateKey(privateKey);
    return finalizeEvent(template, sk);
  }

• src/tools/event-tools.ts:17-25 (schema)

  Zod schema defining the input for signNostrEvent.

  export const signNostrEventSchema = z.object({
    unsignedEvent: z.object({
      kind: z.number(),
      content: z.string(),
      tags: z.array(z.array(z.string())),
      created_at: z.number(),
    }).describe('Unsigned event template'),
    privateKey: z.string().optional().describe(privateKeyDesc),
  });

• src/index.ts:79-81 (registration)

  Tool registration for 'signNostrEvent' within the MCP server.

  server.tool('signNostrEvent', 'Sign any unsigned Nostr event', signNostrEventSchema.shape, async (params) => {
    return textResult(await signNostrEvent(params));
  });