AGA-mcp-server

Instructions

Implementation Reference

• src/tools/quarantine-status.ts:3-18 (handler)

  The main handler for the 'aga_quarantine_status' tool, which checks the portal and quarantine state and returns the forensic capture status.

  export async function handleQuarantineStatus(_args: Record<string, never>, ctx: ServerContext) {
    if (ctx.portal.state !== 'PHANTOM_QUARANTINE' && !ctx.quarantine?.active) {
      return ctx.error('Quarantine status unavailable - portal is not in quarantine state', {
        portal_state: ctx.portal.state,
      });
    }
  
    return ctx.json({
      quarantine_active: ctx.quarantine?.active ?? false,
      started_at: ctx.quarantine?.started_at ?? null,
      inputs_captured: ctx.quarantine?.inputs_captured ?? 0,
      outputs_severed: ctx.quarantine?.outputs_severed ?? false,
      forensic_buffer_size: ctx.quarantine?.forensic_buffer.length ?? 0,
      portal_state: ctx.portal.state,
    });
  }

• src/server.ts:248-253 (registration)

  Registration of the 'aga_quarantine_status' tool in the main MCP server setup.

  // 14. aga_quarantine_status (ungoverned)
  server.tool('aga_quarantine_status',
    'Get quarantine state and forensic capture status. (Claim 5)',
    {},
    async () => handleQuarantineStatus({} as any, ctx),
  );