AGA-mcp-server

Instructions

Implementation Reference

• src/tools/init-chain.ts:5-13 (handler)

  The handler implementation for the aga_init_chain tool.

  export async function handleInitChain(args: { specification_hash?: string }, ctx: ServerContext) {
    if (ctx.chainInitialized) return ctx.error('Chain already initialized');
    const genesis = createGenesisEvent(ctx.chainKP, args.specification_hash ?? sha256Str('AGA Protocol Specification v2.0.0'));
    await ctx.storage.storeEvent(genesis);
    ctx.chainInitialized = true;
    ctx.portal.sequenceCounter = 0;
    ctx.portal.lastLeafHash = genesis.leaf_hash;
    return ctx.json({ success: true, genesis_event_id: genesis.event_id, genesis_leaf_hash: genesis.leaf_hash });
  }

• src/server.ts:80-92 (registration)

  Tool registration of aga_init_chain in the MCP server.

  // 2. aga_init_chain (ungoverned)
  server.tool('aga_init_chain',
    'Initialize continuity chain with genesis event. (Claim 3a)',
    { specification_hash: z.string().optional() },
    async (args) => handleInitChain(args, ctx),
  );
  
  // Also register as init_chain for backward compat
  server.tool('init_chain',
    'Initialize continuity chain (alias for aga_init_chain). (Claim 3a)',
    { specification_hash: z.string().optional() },
    async (args) => handleInitChain(args, ctx),
  );